Documentation site architecture

Learn how we build and architecture gitlab-docs and deploy it to https://docs.gitlab.com.

Repository

While the source of the documentation content is stored in GitLab’s respective product repositories, the source that is used to build the documentation site from that content is located at https://gitlab.com/gitlab-com/gitlab-docs. See the README there for detailed information.

Assets

To provide an optimized site structure, design, and a search-engine friendly website, along with a discoverable documentation, we use a few assets for the GitLab Documentation website.

Libraries

SEO

To understand how the global nav (left sidebar) is built, please read through the global navigation doc.

Deployment

The docs site is deployed to production with GitLab Pages, and previewed in merge requests with Review Apps.

The deployment aspects will be soon transferred from the original document to this page.