doc/development/documentation/site_architecture/_index.md
The docs-gitlab-com project hosts
the repository used to generate the GitLab documentation website and
is deployed to https://docs.gitlab.com. It uses the Hugo
static site generator.
For more information, see the Docs site architecture page.
The documentation source files are in the same repositories as the product code.
| Project | Path |
|---|---|
| GitLab | /doc |
| GitLab Runner | /docs |
| Omnibus GitLab | /doc |
| Charts | /doc |
| GitLab Operator | /doc |
| GitLab CLI (glab) | /docs/source |
Documentation issues and merge requests are part of their respective repositories and all have the label Documentation.
Documentation for GitLab, GitLab Runner, GitLab Operator, Omnibus GitLab, and Charts is published to https://docs.gitlab.com.
The same documentation is included in the application. To view the in-product help,
go to the URL and add /help at the end.
Only help for your current edition and version is included.
Help for other versions is available at https://docs.gitlab.com/archives/.
If you need to add or edit documentation for a GitLab version that has already been released, follow the patch release runbook.
If you have code and documentation in a repository other than the primary repositories, you should keep the documentation with the code in that repository.
Then you can use one of these approaches:
gitlab repository, and add the landing page
to the global navigation, but keep the rest
of the documentation in the external repository. The landing page is indexed and
searchable on https://docs.gitlab.com, but the rest of the documentation is not.
For example, the GitLab for VS Code extension.
We do not encourage the use of pages with lists of links,
so only use this option if the recommended options are not feasible.Translations of GitLab documentation are done through a semi-autonomous process.
The English files are the canonical source files, and the translations
are in language-specific subdirectories under doc-locale or similar. For example, Japanese translations
are in /doc-locale/ja-jp/.
| Project | Path |
|---|---|
| GitLab | /doc-locale |
| GitLab Runner | /docs-locale |
| Omnibus GitLab | /doc-locale |
| Charts | /doc-locale |
| GitLab Operator | /doc-locale |
Development documentation under doc/development or similar is not translated.
You can contribute to the English source files only. The translated files are updated by automation.
The docs website supports versions and each month we add the latest one to the list. For more information, read about the monthly release process.
GitLab uses Danger to automate code review processes.
When documentation files in /doc are modified in a merge request,
Danger Bot automatically comments with documentation-related guidelines.
This automation is configured in the Dangerfile.
To reach to a wider audience, you can request a survey banner.
Only one banner can exist at any given time. Priority is given based on who asked for the banner first.
To request a survey banner:
docs-gitlab-com project and use the "Survey banner request" template.