diff options
| author | Mike Lewis <mlewis@gitlab.com> | 2019-04-15 23:56:35 +0000 |
|---|---|---|
| committer | Mike Lewis <mlewis@gitlab.com> | 2019-04-15 23:56:34 +0000 |
| commit | fe2d4b4db2a12f4654ba665fb3853a27f467f8bb (patch) | |
| tree | b5466a53a7e8d54c06a89d5fa41c4af18862e8d2 | |
| parent | 8c7440b3151fb619c405986c33c5193caeda6638 (diff) | |
| download | gitlab-ce-docs-move-content-from-handbook-and-improve.tar.gz | |
Remove content from Documentation types and organizationdocs-move-content-from-handbook-and-improve
| -rw-r--r-- | doc/development/documentation/index.md | 13 |
1 files changed, 4 insertions, 9 deletions
diff --git a/doc/development/documentation/index.md b/doc/development/documentation/index.md index 0e4ba90af56..16d89bcee24 100644 --- a/doc/development/documentation/index.md +++ b/doc/development/documentation/index.md @@ -16,13 +16,13 @@ In addition to this page, the following resources to help craft and contribute d - [Markdown Guide](https://about.gitlab.com/handbook/product/technical-writing/markdown-guide/) - A reference for the markdown implementation used by GitLab's documentation site and about.gitlab.com. - [Site architecture](site_architecture/index.md) - How docs.gitlab.com is built. -## Source and rendered locations +## Source files and rendered web locations Documentation for GitLab Community Edition (CE) and Enterprise Edition (EE), along with GitLab Runner and Omnibus, is published to [docs.gitlab.com](https://docs.gitlab.com). The documentation for CE and EE is also published within the application at `/help` on the domain of the GitLab instance. At `/help`, only content for your current edition and version is included, whereas multiple versions' content is available at docs.gitlab.com. -The source of the documentation is maintained in the following repository locations: +The source of the documentation exists within the codebase of each GitLab application in the following repository locations: | Project | Path | | --- | --- | @@ -51,16 +51,11 @@ Adhere to the [Documentation Style Guide](styleguide.md). If a style standard is ## Documentation types and organization The documentation is structured based on the GitLab UI structure itself, -separated by [`user`](https://gitlab.com/gitlab-org/gitlab-ce/tree/master/doc/user), +separated primarily by [`user`](https://gitlab.com/gitlab-org/gitlab-ce/tree/master/doc/user), [`administrator`](https://gitlab.com/gitlab-org/gitlab-ce/tree/master/doc/administration), and [`contributor`](https://gitlab.com/gitlab-org/gitlab-ce/tree/master/doc/development). Organize docs by product area and subject, not type. For example, do not create groupings of similar media types -(e.g. indexes of all articles, videos, etc.). - -Similarly, we do not use glossaries or FAQs. Such grouping of content by type makes -it difficult to browse for the information you need and difficult to maintain up-to-date content. -Instead, organize content by its subject (e.g. everything related to CI goes together) -and cross-link between any related content. +(e.g. glossaries, FAQs, or sets of all articles or videos). For more details, see the [Content](styleguide.md#content) section of the [Documentation Style Guide](styleguide.md). |