The following page may contain information related to upcoming products, features and functionality. It is important to note that the information presented is for informational purposes only, so please do not rely on the information for purchasing or planning purposes. Just like with all projects, the items mentioned on the page are subject to change or delay, and the development, release, and timing of any products, features or functionality remain at the sole discretion of GitLab Inc.
Stage | Maturity | Content Last Reviewed |
---|---|---|
Create | Complete | 2020-12-22 |
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. Its source is developed and stored with the product in its respective paths within the GitLab CE, EE, Runner, and Omnibus repositories. The documentation is 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.
Our goal is 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 within the docs in the GitLab Documentation guidelines section.
GitLab Users: Users of GitLab rely on accurate, up-to-date, and comprehensive documentation of the features available.
GitLab Team Members: GitLab team members are both contributors to and consumers of the documentation. While the Technical Writing team owns the documentation, all team members can and do contribute to the them.
Leadership & Decision-makers: The GitLab documentation site is a valuable resource for decision-makers to compare features across versions and evaluate implementation details that may impact a purchasing decision.
A recent round of UX research highlighted a few key opportunities for improving the GitLab documentation site:
Troubleshooting
information is the among the most difficult content to find/help
and docs.gitlab.com
is confusingOur current focus is on improving the information architecture, usability, and overall content of the documentation. Specifically, we're working to:
Additionally, we want to lower the barrier to contributing changes by integrating the static site editor.
As outlined in the Documentation Roadmap epic there are a number of improvements prioritized to address the challenges listed above.
/help
and docs.gitlab.com
experiences and making the documentation available offline for airgapped instances will clarify where to look for the relevant documentation.In addition, we're planning to invest in an improved search experience, end-to-end tutorial content, and context-aware documentation.
At this time, we are not investigating any significant architectural changes to the documentation site itself, like migrating to a new static site generator.
We're not currently investing in localization of the documentation.
Currently, the GitLab Documentation Site category is a non-marketing category which means its maturity does not get tracked. However, for the sake of measuring improvement, the GitLab Documentation Site is marked as Complete
with intentions of moving it to Lovable
.