diff options
| author | Marcia Ramos <virtua.creative@gmail.com> | 2017-03-16 15:58:04 -0300 |
|---|---|---|
| committer | Marcia Ramos <virtua.creative@gmail.com> | 2017-03-16 15:58:04 -0300 |
| commit | dda8896e9382b6e306e8a06bf4bf144f0815c49c (patch) | |
| tree | c53c44537d47adb886fcbe65ab638cfea9bab37d /doc/development | |
| parent | e4cd6c683be59b66778b9612f1cfbe0c3f740eee (diff) | |
| download | gitlab-ce-dda8896e9382b6e306e8a06bf4bf144f0815c49c.tar.gz | |
rename "documentation articles" to "technical articles"
Diffstat (limited to 'doc/development')
| -rw-r--r-- | doc/development/doc_styleguide.md | 2 | ||||
| -rw-r--r-- | doc/development/writing_documentation.md | 6 |
2 files changed, 4 insertions, 4 deletions
diff --git a/doc/development/doc_styleguide.md b/doc/development/doc_styleguide.md index 7c0013aa476..1d4dfeea6b1 100644 --- a/doc/development/doc_styleguide.md +++ b/doc/development/doc_styleguide.md @@ -27,7 +27,7 @@ The table below shows what kind of documentation goes where. | `doc/legal/` | Legal documents about contributing to GitLab. | | `doc/install/`| Probably the most visited directory, since `installation.md` is there. Ideally this should go under `doc/administration/`, but it's best to leave it as-is in order to avoid confusion (still debated though). | | `doc/update/` | Same with `doc/install/`. Should be under `administration/`, but this is a well known location, better leave as-is, at least for now. | -| `doc/topics/` | Indexes per Topic (`doc/topics/topic-name/index.md`); Documentation Articles: user guides, admin guides, technical overviews, tutorials (`doc/topics/topic-name/`). | +| `doc/topics/` | Indexes per Topic (`doc/topics/topic-name/index.md`); Technical Articles: user guides, admin guides, technical overviews, tutorials (`doc/topics/topic-name/`). | --- diff --git a/doc/development/writing_documentation.md b/doc/development/writing_documentation.md index 39a8204c629..c0440604297 100644 --- a/doc/development/writing_documentation.md +++ b/doc/development/writing_documentation.md @@ -1,10 +1,10 @@ # Writing Documentation - **General Documentation**: written by the developers responsible by creating features. Should be submitted in the same merge request containing code. Feature proposals (by GitLab contributors) should also be accompanied by its respective documentation. They can be later improved by PMs and Technical Writers. - - **Documentation Articles**: written by any GitLab Team member, GitLab contributors, or Community Writers. + - **Technical Articles**: written by any GitLab Team member, GitLab contributors, or Community Writers. - **Indexes per topic**: initially prepared by the Technical Writing Team, and kept up-to-date by developers and PMs, in the same merge request containing code. -## Distinction between General Documentation and Documentation Articles +## Distinction between General Documentation and Technical Articles Every **Documentation Article** contains, in the very beginning, a blockquote with the following information: @@ -20,7 +20,7 @@ Every **Documentation Article** contains, in the very beginning, a blockquote wi General documentation is categorized by _User_, _Admin_, and _Contributor_, and describe what that feature is, and how to use it or set it up. -## Documentation Articles - Writing Method +## Technical Articles - Writing Method Use the [writing method](https://about.gitlab.com/handbook/marketing/developer-relations/technical-writing/#writing-method) defined by the Technical Writing team. |