diff options
author | Marcia Ramos <virtua.creative@gmail.com> | 2017-03-16 23:13:57 +0300 |
---|---|---|
committer | Marcia Ramos <virtua.creative@gmail.com> | 2017-03-16 23:13:57 +0300 |
commit | f94b656732b1dbebd634b53fb5ff6ab130a3b638 (patch) | |
tree | ea8ebc90d401e880b23e07648225823766bb1e24 /doc/development/writing_documentation.md | |
parent | c6a091d63a5bd62004e48c786823459c2307d0bd (diff) |
add examples of guide vs tutorial
Diffstat (limited to 'doc/development/writing_documentation.md')
-rw-r--r-- | doc/development/writing_documentation.md | 6 |
1 files changed, 5 insertions, 1 deletions
diff --git a/doc/development/writing_documentation.md b/doc/development/writing_documentation.md index a8cb967b0c7..2aa37d04922 100644 --- a/doc/development/writing_documentation.md +++ b/doc/development/writing_documentation.md @@ -29,12 +29,16 @@ They live under `doc/topics/topic-name/`, and can be searched per topic, within #### Understanding Guides and Tutorials -Suppose there's a process to go from point A to point B in 5 steps: (A) 1 > 2 > 3 > 4 > 5 (B). +Suppose there's a process to go from point A to point B in 5 steps: `(A) 1 > 2 > 3 > 4 > 5 (B)`. A **guide** can be understood as a description of certain processes to achieve a particular objective. A guide brings you from A to B describing the characteristics of that process, but not necessarily going over each step. It can mention, for example, the step 3, but, assumes that that step is known by the reader, or out of the scope of that article. +- Live example: "GitLab Pages from A to Z - [Part 1](../user/project/pages/getting_started_part_one.html) to [Part 4](../user/project/pages/getting_started_part_one.html)" + A **tutorial** requires a clear **step-by-step** guidance to achieve a singular objective. It brings you from A to B, describing precisely all the necessary steps involved in that process, showing each of the 5 steps to go from A to B. It does not assume that you step 3: it shows you each of them. +- Live example (on the blog): [Hosting on GitLab.com with GitLab Pages](https://about.gitlab.com/2016/04/07/gitlab-pages-setup/) + #### Special Format Every **Technical Article** contains, in the very beginning, a blockquote with the following information: |