Building a new GitLab Docs site with Nanoc, GitLab CI, and GitLab Pages

This post details the rebuilding of the GitLab Docs site using Nanoc, GitLab CI, and GitLab Pages. It describes the build process, including cloning documentation from multiple repositories (CE, EE, Omnibus, Runner) into a single Nanoc project, using Rake tasks for repository management, and leveraging Nanoc's rules for Markdown processing (Redcarpet, Rouge for syntax highlighting) and asset handling. It also outlines the CI/CD pipeline for testing (link validation, SCSS linting), building, and deploying the static site to GitLab Pages.