GitLab’s documentation is crafted to help users, admins, and decision-makers learn about GitLab features and to optimally implement and use GitLab to meet their DevOps needs.
The documentation is an essential part of the product. Its source is developed
and stored with the product in its respective paths within the
It's published at docs.gitlab.com (offering multiple
versions of all products’ documentation) and at the
/help/ path on each GitLab
instance’s domain, with content for that instance’s version and edition.
It's GitLab’s goal to create documentation that is complete, accurate, and easy to use. It should be easy to browse or search for the information you need, and easy to contribute to the documentation itself.
All standards and practices for contributing documentation are found in the GitLab Documentation guidelines.
Everyone can contribute. For documentation needs resulting from the development and release of new or enhanced features, the developer responsible for the code writes or updates the documentation.
Technical writers monitor the planning and merging of documentation, reviewing all changes after they are merged, unless they are brought in to the process earlier for specific questions, reviews, or projects.
For more information on these processes, see the Documentation section of our Development documentation.
Anyone with master access at GitLab is welcome to merge documentation changes to GitLab's master branches, provided they believe the content is:
GitLab's technical writers review all merged content to confirm it is clear and meets the structure and style guidelines, often making additional improvements.
Note that documentation doesn't need to be perfect in structure and style to merge. It's better to publish an improved documentation page and then later refine it than to hold a documentation page in a review process, where users don't know it exists or are using an inferior version of the documentation page.
However, if you know or suspect that a documentation page has been merged while in need of further enhancement, please create another MR or issue for this work.
For more information, see the Documentation section of our Development documentation.
The documentation site at docs.gitlab.com is built by the GitLab Docs project, as described in the Site Architecture section of the documentation. The project is owned by the Editor group, with work primarily planned by the Technical Writing team.
GitLab Docs project work is managed on the following issue boards:
~"workflow:problem validation": From the set of open issues, the TW Leadership Team has identified these for consideration for development, though in need of validation through research, whether by Technical Writing or UX Research.
~"workflow:design": The issue has been assigned to a Product Designer to propose any needed designs.
~"workflow:refinement": The issue is not in need of problem validation or design, but needs further detail in order to be ready for Engineering.
~"workflow:planning breakdown": The issue is ready for the Editor team to prepare for work and implement. This is the first label displayed on their Development Workflow board.
For more information about the team and how it works to continually improve GitLab's documentation, see Technical Writing in the Product section of the handbook.