diff options
author | Marcia Ramos <virtua.creative@gmail.com> | 2018-02-16 21:01:35 +0300 |
---|---|---|
committer | Marcia Ramos <virtua.creative@gmail.com> | 2018-02-16 21:01:35 +0300 |
commit | d54a80ca3a25612ffb85e47de769a7967999a232 (patch) | |
tree | f8550180262d45952c5cd4b92cd063e34b7bdeae /doc/development | |
parent | 71ba3982636d19b6c8208180ff5626a405cc23fc (diff) |
Update all articles with the new layout (meta data from the frontmatter)
Context: https://gitlab.com/gitlab-com/gitlab-docs/merge_requests/182
Diffstat (limited to 'doc/development')
-rw-r--r-- | doc/development/writing_documentation.md | 31 |
1 files changed, 19 insertions, 12 deletions
diff --git a/doc/development/writing_documentation.md b/doc/development/writing_documentation.md index 2a1d744668b..ceb0cdbb742 100644 --- a/doc/development/writing_documentation.md +++ b/doc/development/writing_documentation.md @@ -254,18 +254,25 @@ through the process of how to use it systematically. #### Special format -Every **Technical Article** contains, in the very beginning, a blockquote with the following information: - -- A reference to the **type of article** (user guide, admin guide, tech overview, tutorial) -- A reference to the **knowledge level** expected from the reader to be able to follow through (beginner, intermediate, advanced) -- A reference to the **author's name** and **GitLab.com handle** -- A reference of the **publication date** - -```md -> **[Article Type](../../development/writing_documentation.html#types-of-technical-articles):** tutorial || -> **Level:** intermediary || -> **Author:** [Name Surname](https://gitlab.com/username) || -> **Publication date:** AAAA-MM-DD +Every **Technical Article** contains a frontmatter at the beginning of the doc +with the following information: + +- **Type of article** (user guide, admin guide, tech overview, tutorial) +- **Knowledge level** expected from the reader to be able to follow through (beginner, intermediate, advanced) +- **Author's name** and **GitLab.com handle** +- **Publication date** + +For example: + + +```yaml +--- +author: John Doe +author_gitlab: johnDoe +level: beginner +article_type: user guide +date: 2017-02-01 +--- ``` #### Technical Articles - Writing Method |