[{"data":1,"prerenderedAt":716},["ShallowReactive",2],{"/en-us/blog/building-a-new-gitlab-docs-site-with-nanoc-gitlab-ci-and-gitlab-pages/":3,"navigation-en-us":32,"banner-en-us":461,"footer-en-us":478,"Connor Shea":688,"next-steps-en-us":701},{"_path":4,"_dir":5,"_draft":6,"_partial":6,"_locale":7,"seo":8,"content":16,"config":22,"_id":25,"_type":26,"title":27,"_source":28,"_file":29,"_stem":30,"_extension":31},"/en-us/blog/building-a-new-gitlab-docs-site-with-nanoc-gitlab-ci-and-gitlab-pages","blog",false,"",{"title":9,"description":10,"ogTitle":9,"ogDescription":10,"noIndex":6,"ogImage":11,"ogUrl":12,"ogSiteName":13,"ogType":14,"canonicalUrls":12,"schema":15},"Building a new GitLab Docs site with Nanoc, GitLab CI, and GitLab Pages","How we built the new GitLab Docs portal from the ground up","https://res.cloudinary.com/about-gitlab-com/image/upload/v1749666603/Blog/Hero%20Images/book.jpg","https://about.gitlab.com/blog/building-a-new-gitlab-docs-site-with-nanoc-gitlab-ci-and-gitlab-pages","https://about.gitlab.com","article","\n                        {\n        \"@context\": \"https://schema.org\",\n        \"@type\": \"Article\",\n        \"headline\": \"Building a new GitLab Docs site with Nanoc, GitLab CI, and GitLab Pages\",\n        \"author\": [{\"@type\":\"Person\",\"name\":\"Connor Shea\"}],\n        \"datePublished\": \"2016-12-07\",\n      }",{"title":9,"description":10,"authors":17,"heroImage":11,"date":19,"body":20,"category":21},[18],"Connor Shea","2016-12-07","We recently rebuilt [docs.gitlab.com](https://docs.gitlab.com) from scratch.\nWhere previously the site was generated with a simple Ruby script, we now\nuse a proper static site generator.\n\n\nCheck out the improvements we made, the structure we now use to deploy from\nspecific directories in multiple repositories to a single website, build\nwith [GitLab CI](/solutions/continuous-integration/) and deployed with\n[GitLab Pages][pages]. Now our documentation has a nicer look and feel, is\nmore pleasant to read through, and simpler and quicker to maintain.\n\n\n\u003C!-- more -->\n\n\n- TOC\n\n{:toc}\n\n\n## Improvements\n\n\nThe old documentation website was pretty much just an HTML file, a\nstylesheet, and a [Ruby script][genrb] called `generate.rb`. While it\nworked, it was hard to update and not very flexible. It mostly laid dormant,\nonly occasionally being touched by developers. The docs team really wanted\nto update the site to use a [static site\ngenerator](/blog/ssg-overview-gitlab-pages-part-3-examples-ci/) and take\nbetter advantage of [GitLab Pages][pages].\n\n\nWe chose [Nanoc](https://nanoc.ws/) because it’s fast, it comes with a\nnumber of built-in helpers and filters (as well as the ability to create\ncustom ones), and it’s built with Ruby. Overall, we think this was\ndefinitely the right choice. The author was very responsive and addressed\nanything we brought up. Kudos to him on the great project!\n\n\nOther improvements include syntax highlighting with\n[Rouge](http://rouge.jneen.net/) (no syntax highlighting was used at all on\nthe old site), breadcrumbs for navigating between pages, and an improved\noverall design – especially on mobile.\n\n\n## Requirements\n\n\nOur documentation site has some unique requirements that I haven’t seen\nmentioned or solved in any other companies’ blog posts. We have a few\nproducts with documentation we want to include in the site: Community\nEdition, Enterprise Edition, Omnibus GitLab, and GitLab Runner. In the\nfuture we’ll likely add more.\n\n\nEach product has it own repository with its own documentation directory.\nThis allows developers to add documentation in the same merge request they\nadd a new feature or change some behavior, which prevents documentation from\nbecoming outdated.\n\n\nThe site also needed to be flexible enough that we could add versioning to\nit in the future. Eventually, our goal is to replace the Help section in\nCE/EE with this Docs site, so we need to maintain older versions of the\ndocumentation on the Docs site for users on older versions of GitLab.\n\n\n## The build process\n\n\nGiven the requirements and separate repositories, we decided we’d just need\nto clone the repositories as part of the build process.\n\n\nInside Nanoc's config file (`nanoc.yml`), we [have defined][nanocyaml] a\nhash of each of our products containing all the data we need. Here's an\nexcerpt:\n\n\n```yaml\n\nproducts:\n  ce:\n    full_name: 'GitLab Community Edition'\n    short_name: 'Community Edition'\n    abbreviation: 'CE'\n    slug: 'ce'\n    index_file: 'README.*'\n    description: 'Browse user and administration documentation and guides for GitLab Community Edition.'\n    repo: 'https://gitlab.com/gitlab-org/gitlab-ce.git'\n    dirs:\n      temp_dir: 'tmp/ce/'\n      dest_dir: 'content/ce'\n      doc_dir:  'doc'\n\n...\n\n  runner:\n    full_name: 'GitLab Runner'\n    short_name: 'Runner'\n    abbreviation: 'RU'\n    slug: 'runner'\n    index_file: 'index.*'\n    description: 'Browse installation, configuration, maintenance, and troubleshooting documentation for GitLab Runner.'\n    repo: 'https://gitlab.com/gitlab-org/gitlab-runner.git'\n    dirs:\n      temp_dir: 'tmp/runner/'\n      dest_dir: 'content/runner'\n      doc_dir:  'docs'\n```\n\n\nWe then have the [Rakefile] where the repos are cloned and the directories\nthat\n\nNanoc needs are created:\n\n\n```ruby\n\ndesc 'Pulls down the CE, EE, Omnibus and Runner git repos and merges the\ncontent of their doc directories into the nanoc site'\n\ntask :pull_repos do\n  require 'yaml'\n\n  # By default won't delete any directories, requires all relevant directories\n  # be empty. Run `RAKE_FORCE_DELETE=true rake pull_repos` to have directories\n  # deleted.\n  force_delete = ENV['RAKE_FORCE_DELETE']\n\n  # Parse the config file and create a hash.\n  config = YAML.load_file('./nanoc.yaml')\n\n  # Pull products data from the config.\n  ce = config[\"products\"][\"ce\"]\n  ee = config[\"products\"][\"ee\"]\n  omnibus = config[\"products\"][\"omnibus\"]\n  runner = config[\"products\"][\"runner\"]\n\n  products = [ce, ee, omnibus, runner]\n  dirs = []\n  products.each do |product|\n    dirs.push(product['dirs']['temp_dir'])\n    dirs.push(product['dirs']['dest_dir'])\n  end\n\n  if force_delete\n    puts \"WARNING: Are you sure you want to remove #{dirs.join(', ')}? [y/n]\"\n    exit unless STDIN.gets.index(/y/i) == 0\n\n    dirs.each do |dir|\n      puts \"\\n=> Deleting #{dir} if it exists\\n\"\n      FileUtils.rm_r(\"#{dir}\") if File.exist?(\"#{dir}\")\n    end\n  else\n    puts \"NOTE: The following directories must be empty otherwise this task \" +\n      \"will fail:\\n#{dirs.join(', ')}\"\n    puts \"If you want to force-delete the `tmp/` and `content/` folders so \\n\" +\n      \"the task will run without manual intervention, run \\n\" +\n      \"`RAKE_FORCE_DELETE=true rake pull_repos`.\"\n  end\n\n  dirs.each do |dir|\n    unless \"#{dir}\".start_with?(\"tmp\")\n\n      puts \"\\n=> Making an empty #{dir}\"\n      FileUtils.mkdir(\"#{dir}\") unless File.exist?(\"#{dir}\")\n    end\n  end\n\n  products.each do |product|\n    temp_dir = File.join(product['dirs']['temp_dir'])\n    puts \"\\n=> Cloning #{product['repo']} into #{temp_dir}\\n\"\n\n    `git clone #{product['repo']} #{temp_dir} --depth 1 --branch master`\n\n    temp_doc_dir = File.join(product['dirs']['temp_dir'], product['dirs']['doc_dir'], '.')\n    destination_dir = File.join(product['dirs']['dest_dir'])\n    puts \"\\n=> Copying #{temp_doc_dir} into #{destination_dir}\\n\"\n    FileUtils.cp_r(temp_doc_dir, destination_dir)\n  end\nend\n\n```\n\n\nThe `pull_repos` task inside the Rakefile is pretty self-explanatory if you\nknow\n\nsome Ruby, but here's what it does:\n\n\n1. `nanoc.yml` is loaded since it contains the information we need for the\n   various products:\n\n    ```ruby\n    config = YAML.load_file('./nanoc.yaml')\n    ```\n\n1. The products data are pulled from the config:\n\n    ```ruby\n    ce = config[\"products\"][\"ce\"]\n    ee = config[\"products\"][\"ee\"]\n    omnibus = config[\"products\"][\"omnibus\"]\n    runner = config[\"products\"][\"runner\"]\n    ```\n\n1. The needed directories to be created (or deleted) are populated in an\narray:\n\n    ```ruby\n    products = [ce, ee, omnibus, runner]\n    dirs = []\n    products.each do |product|\n      dirs.push(product['dirs']['temp_dir'])\n      dirs.push(product['dirs']['dest_dir'])\n    end\n    ```\n\n1. The empty directories are created:\n\n    ```ruby\n    dirs.each do |dir|\n      unless \"#{dir}\".start_with?(\"tmp\")\n\n        puts \"\\n=> Making an empty #{dir}\"\n        FileUtils.mkdir(\"#{dir}\") unless File.exist?(\"#{dir}\")\n      end\n    end\n    ```\n1. We finally copy the contents of the documentation directory (defined by\n   `doc_dir`) for each product from `tmp/` to `content/`:\n\n    ```ruby\n    products.each do |product|\n      temp_dir = File.join(product['dirs']['temp_dir'])\n      puts \"\\n=> Cloning #{product['repo']} into #{temp_dir}\\n\"\n\n      `git clone #{product['repo']} #{temp_dir} --depth 1 --branch master`\n\n      temp_doc_dir = File.join(product['dirs']['temp_dir'], product['dirs']['doc_dir'], '.')\n      destination_dir = File.join(product['dirs']['dest_dir'])\n      puts \"\\n=> Copying #{temp_doc_dir} into #{destination_dir}\\n\"\n      FileUtils.cp_r(temp_doc_dir, destination_dir)\n    end\n    ```\n\n   `content/` is where Nanoc looks for the actual site’s Markdown files. To prevent the `tmp/` and `content/` subdirectories from being pushed after testing the site locally, they’re excluded by `.gitignore`.\n\nIn the future we may speed this up further by caching the `tmp` folder in\nCI. The task would need to be updated to check if the local repository is\nup-to-date with the remote, only cloning if they differ.\n\n\nNow that all the needed files are in order, we run `nanoc` to build the\nstatic sire. Nanoc runs each Markdown file through a series of\n[filters][nanoc-filters] defined by rules in the [`Rules` file][rules]. We\ncurrently use [Redcarpet][] as the Markdown parser along with Rouge for\nsyntax highlighting, as well as some custom filters. We plan on [moving to\nKramdown as our Markdown parser in the\nfuture](https://gitlab.com/gitlab-org/gitlab-docs/issues/50) as it provides\nsome nice stuff like user-defined Table of Contents, etc.\n\n\nWe also define some filters inside the [`lib/filters/`\ndirectory][filtersdir],\n\nincluding one that [replaces any `.md` extension with `.html`][md2html].\n\n\nThe Table of Contents (ToC) is generated for each page except when it's\nnamed `index.md`\n\nor `README.md` as we usually use these as landing pages to index other\n\ndocumentation files and we don't want them to have a ToC. All this and some\n\nother options that Redcarpet provides [are defined in the `Rules`\nfile][redrules].\n\n\nFor more on the specifics of building a site with Nanoc, see [the Nanoc\ntutorial](https://nanoc.ws/doc/tutorial/).\n\n\n## Taking advantage of GitLab to put everything together\n\n\nThe new docs portal is hosted on GitLab.com at\n\u003Chttps://gitlab.com/gitlab-org/gitlab-docs>.\n\nIn that project we create issues, discuss things, open merge requests in\nfeature\n\nbranches, iterate on feedback and finally merge things in the `master`\nbranch.\n\nAgain, the documentation source files are not stored in this repository, if\n\nyou want to contribute, you'd have to open a merge request to the respective\n\nproject.\n\n\nThere are 3 key things we use to test, build, deploy and host the Nanoc site\n\nall built into GitLab: [GitLab CI](/solutions/continuous-integration/),\n[Review Apps](https://docs.gitlab.com/ee/ci/review_apps/)\n\nand [GitLab Pages][pages].\n\n\nLet's break it down to pieces.\n\n\n### GitLab CI\n\n\nGitLab CI is responsible of all the stages that we go through to publish\n\nnew documentation: test, build and deploy.\n\n\nNanoc has a built-in system of [Checks](https://nanoc.ws/doc/testing/),\nincluding HTML/CSS and internal/external link validation. With GitLab CI we\ntest with the internal link checker (set to [`allow failure`][allowfail])\nand also verify that the site compiles without errors. We also run a [SCSS\nLinter](https://github.com/sasstools/sass-lint) to make sure our SCSS looks\nuniform.\n\n\nOur full\n[`.gitlab-ci.yml`](https://gitlab.com/gitlab-org/gitlab-docs/blob/master/.gitlab-ci.yml)\nfile looks like this. We'll break it down to make it clear what it is doing:\n\n\n```yaml\n\nimage: ruby:2.3\n\n\n## Cache the vendor/ruby directory\n\ncache:\n  key: \"ruby-231\"\n  paths:\n  - vendor/ruby\n\n## Define the stages\n\nstages:\n  - test\n  - deploy\n\n## Before each job's script is run, run the commands below\n\nbefore_script:\n  - ruby -v\n  - bundle install --jobs 4 --path vendor\n\n## Make sure the site builds successfully\n\nverify_compile:\n  stage: test\n  script:\n    - rake pull_repos\n    - nanoc\n  artifacts:\n    paths:\n      - public\n    expire_in: 1w\n  except:\n    - master\n  tags:\n    - docker\n\n## Check for dead internal links using Nanoc's built-in tool\n\ninternal_links:\n  stage: test\n  script:\n    - rake pull_repos\n    - nanoc\n    - nanoc check internal_links\n  allow_failure: true\n  tags:\n    - docker\n\n## Make sure our SCSS stylesheets are correctly defined\n\nscss_lint:\n  stage: test\n  script:\n    - npx sass-lint '**/*.scss' -v\n  tags:\n    - docker\n\n## A job that deploys a review app to a dedicated server running Nginx.\n\nreview:\n  stage: deploy\n  variables:\n    GIT_STRATEGY: none\n  before_script: []\n  cache: {}\n  script:\n    - rsync -av --delete public /srv/nginx/pages/$CI_BUILD_REF_NAME\n  environment:\n    name: review/$CI_BUILD_REF_NAME\n    url: http://$CI_BUILD_REF_NAME.$APPS_DOMAIN\n    on_stop: review_stop\n  only:\n    - branches@gitlab-org/gitlab-docs\n  except:\n    - master\n  tags:\n    - nginx\n    - review-apps\n\n## Stop the review app\n\nreview_stop:\n  stage: deploy\n  variables:\n    GIT_STRATEGY: none\n  before_script: []\n  artifacts: {}\n  cache: {}\n  dependencies: []\n  script:\n    - rm -rf public /srv/nginx/pages/$CI_BUILD_REF_NAME\n  when: manual\n  environment:\n    name: review/$CI_BUILD_REF_NAME\n    action: stop\n  only:\n    - branches@gitlab-org/gitlab-docs\n  except:\n    - master\n  tags:\n    - nginx\n    - review-apps\n\n## Deploy the static site to GitLab Pages\n\npages:\n  stage: deploy\n  environment:\n    name: production\n    url: https://docs.gitlab.com\n  script:\n    - rake pull_repos\n    - nanoc\n    # Symlink all README.html to index.html\n    - for i in `find public -name README.html`; do ln -sf README.html $(dirname $i)/index.html; done\n  artifacts:\n    paths:\n    - public\n    expire_in: 1h\n  only:\n    - master@gitlab-org/gitlab-docs\n  tags:\n    - docker\n```\n\n\nTo better visualize how the jobs are run, take a look at how the pipeline\n\ngraph looks like for [one of the pipelines][pipeline].\n\n\n![Pipeline graph\nexample](https://about.gitlab.com/images/blogimages/new-gitlab-docs-site/pipeline-graph.png){:\n.shadow}\n\n\nLet's see what all these settings mean.\n\n\nFor more information, you can read the [documentation on\n`.gitlab-ci.yml`][ciyaml].\n\n{: .alert .alert-info}\n\n\n---\n\n\nDefine the Docker image to be used:\n\n\n```yaml\n\nimage: ruby:2.3\n\n```\n\n\n[Cache] the vendor/ruby directory so that we don't have to install the\n\ngems for each job/pipeline:\n\n\n```yaml\n\ncache:\n  key: \"ruby-231\"\n  paths:\n  - vendor/ruby\n```\n\n\nDefine the [stages] the jobs will run:\n\n\n```yaml\n\nstages:\n  - test\n  - deploy\n```\n\n\nBefore each job's script is run, run the commands that are defined in the\n\n[`before_script`][before_script]. Display the Ruby version and install\n\nthe needed gems:\n\n\n```yaml\n\nbefore_script:\n  - ruby -v\n  - bundle install --jobs 4 --path vendor\n```\n\n\nIn the `verify_compile` job we make sure the site builds successfully.\n\nIt first pulls the repos locally, then runs `nanoc` to compile the site.\n\nThe `public/` directory where the static site is built, is uploaded as\n\nan artifact so that it can pass between stages. We define an expire date of\n\none week. The job runs on all refs except master. The `docker` tag ensures\nthat\n\nthis job is picked by the shared Runners on GitLab.com:\n\n\n```yaml\n\nverify_compile:\n  stage: test\n  script:\n    - rake pull_repos\n    - nanoc\n  artifacts:\n    paths:\n      - public\n    expire_in: 1w\n  except:\n    - master\n  tags:\n    - docker\n```\n\n\nIn the `internal_links` job we check for dead internal links using Nanoc's\n\nbuilt-in functionality. We first need to pull the repos and compile the\nstatic\n\nsite. We allow it to fail since the source of the dead links are in a\n\ndifferent repository, not much related with the current one.\n\nThe `docker` tag ensures that this job is picked by the shared Runners\n\non GitLab.com:\n\n\n```yaml\n\ninternal_links:\n  stage: test\n  script:\n    - rake pull_repos\n    - nanoc\n    - nanoc check internal_links\n  allow_failure: true\n  tags:\n    - docker\n```\n\n\nThe `scss_lint` job makes sure our SCSS stylesheets are correctly defined by\n\nrunning a linter on them. The `docker` tag ensures that this job is picked\nby\n\nthe shared Runners on GitLab.com:\n\n\n```yaml\n\nscss_lint:\n  stage: test\n  script:\n    - npx sass-lint '**/*.scss' -v\n  tags:\n    - docker\n\n```\n\n\nNext, we define the Review Apps.\n\n\n### Review Apps\n\n\nWhen opening a merge request for the docs site we use a new feature called\n[Review Apps](https://docs.gitlab.com/ee/ci/review_apps/) to test changes. This\nlets us test new features, style changes, new sections, etc., by deploying\nthe updated static site to a test domain. On every merge request that all\njobs finished successfully, we can see a link with the URL to the temporary\ndeployed docs site.\n\n\n![Review\napps](https://about.gitlab.com/images/blogimages/gitlab-docs-review-apps-screenshot.png){:\n.shadow}\n\n\nWe define two additional jobs for that purpose in `.gitlab-ci.yml`:\n\n\n```yaml\n\nreview:\n  stage: deploy\n  variables:\n    GIT_STRATEGY: none\n  before_script: []\n  cache: {}\n  script:\n    - rsync -av --delete public /srv/nginx/pages/$CI_BUILD_REF_NAME\n  environment:\n    name: review/$CI_BUILD_REF_NAME\n    url: http://$CI_BUILD_REF_NAME.$APPS_DOMAIN\n    on_stop: review_stop\n  only:\n    - branches@gitlab-org/gitlab-docs\n  except:\n    - master\n  tags:\n    - nginx\n    - review-apps\n\nreview_stop:\n  stage: deploy\n  variables:\n    GIT_STRATEGY: none\n  before_script: []\n  artifacts: {}\n  cache: {}\n  dependencies: []\n  script:\n    - rm -rf public /srv/nginx/pages/$CI_BUILD_REF_NAME\n  when: manual\n  environment:\n    name: review/$CI_BUILD_REF_NAME\n    action: stop\n  only:\n    - branches@gitlab-org/gitlab-docs\n  except:\n    - master\n  tags:\n    - nginx\n    - review-apps\n```\n\n\nThey both run on all branches except `master` since `master` is deployed\nstraight\n\nto production. Once someone with write access to the repository pushes a\nbranch\n\nand creates a merge request, if the jobs in the `test` stage finish\nsuccessfully,\n\nthe `review` job deploys the code of that particular branch to a server. The\n\nserver is set up to [use Nginx with Review Apps][nginx-example], and it uses\n\nthe artifacts from the previously `verify_compile` job which contain the\n\n`public/` directory with the HTML files Nanoc compiled.\n\n\nNotice that both jobs rely on [dynamic environments][environments] and with\n\nthe `review/` prefix we can group them under the [Environments\npage](https://gitlab.com/gitlab-org/gitlab-docs/environments).\n\n\nThe `review_stop` job depends on the `review` one and is called whenever we\n\nwant to clear up the review app. By default it is called every time the\nrelated\n\nbranch is deleted, but you can also manually call it with the buttons that\ncan\n\nbe found in GitLab.\n\n\nThe trick of this particular set up is that we use the shared Runners\nprovided\n\nin GitLab.com to test and build the docs site (using Docker containers)\nwhereas\n\nwe use a specific Runner that is set up in the server that hosts the Review\nApps\n\nand is configured with the [shell executor]. GitLab CI knows what Runner to\nuse\n\neach time from the `tags` we provide each job with.\n\n\nThe `review` job has also some other things specified:\n\n\n```yaml\n\nvariables:\n  GIT_STRATEGY: none\nbefore_script: []\n\ncache: {}\n\n```\n\n\nIn this case, [`GIT_STRATEGY`][gitstrategy] is set up to `none` since we\ndon't need to\n\ncheckout the repository for this job. We only use `rsync` to copy over the\n\nartifacts that were passed from the previous job to the server where Review\n\nApps are deployed. We also turn off the `before_script` since we don't need\nit\n\nto run, same for `cache`. They both are defined globally, so you need to\npass\n\nan empty array and hash respectively to disable them in a job level.\n\n\nOn the other hand, setting the `GIT_STRATEGY` to `none` is necessary on the\n\n`review_stop` job so that the GitLab Runner won't try to checkout the code\nafter\n\nthe branch is deleted. We also define one additional thing in it:\n\n\n```yaml\n\ndependencies: []\n\n```\n\n\nSince this is the last job that is performed in the lifecycle of a merge\nrequest\n\n(after it's merged and the branch deleted), we opt to not download any\nartifacts\n\nfrom the previous stage with passing an empty array in\n[`dependencies`][deps].\n\n\n---\n\n\nSee [our blog post on Review Apps](/blog/introducing-review-apps/) for\n\nmore information about how they work and their purpose. Be sure to also\ncheck\n\nthe [Review Apps documentation][radocs] as well as [how dynamic environments\nwork][environments]\n\nsince they are the basis of the Review Apps.\n\n\nThe final step after the site gets successfully built is to deploy to\n\nproduction which is under the URL everybody knows:\n\u003Chttps://docs.gitlab.com>.\n\nFor that purpose, we use [GitLab Pages][pages].\n\n\n### GitLab Pages\n\n\n[GitLab Pages](https://pages.gitlab.io/) hosts [static\nwebsites](https://en.wikipedia.org/wiki/Static_web_page) and can be used\nwith any Static Site Generator, including [Jekyll](https://jekyllrb.com/),\n[Hugo](https://gohugo.io/), [Middleman](https://middlemanapp.com/),\n[Pelican](http://blog.getpelican.com/), and of course Nanoc.\n\n\nGitLab Pages allows us to create the static site dynamically since it just\ndeploys the `public` directory after the GitLab CI task is done. The job\nresponsible for this is named `pages`.\n\n\nA production environment is set with a url to the of the docs portal.\n\nThe script pulls the repos, runs `nanoc` to compile the static site.\n\nThe `public/` directory where the static site is built, is uploaded as\n\nan artifact so that it can be deployed to GitLab Pages. We define an expire\n\ndate of one hour and the job runs only on the master branch.\n\nThe `docker` tag ensures that this job is picked by the shared Runners\n\non GitLab.com.\n\n\n```yaml\n\npages:\n  stage: deploy\n  environment:\n    name: production\n    url: https://docs.gitlab.com\n  script:\n    - rake pull_repos\n    - nanoc\n    # Symlink all README.html to index.html\n    - for i in `find public -name README.html`; do ln -sf README.html $(dirname $i)/index.html; done\n  artifacts:\n    paths:\n    - public\n    expire_in: 1h\n  only:\n    - master@gitlab-org/gitlab-docs\n  tags:\n    - docker\n```\n\n\nGitLab Pages deploys our documentation site whenever a commit is made to the\nmaster branch of the gitlab-docs repository and is run only on the `master`\nbranch of the gitlab-docs project.\n\n\nSince the documentation content itself is not hosted under the gitlab-docs\nrepository, we rely to a CI job under all the products we build the docs\nsite from. We specifically [make use of triggers][triggers] where a build\nfor the docs site is triggered whenever CI runs successfully on the master\nbranches of CE, EE, Omnibus GitLab, or Runner. If you go to the [pipelines\npage of the gitlab-docs project][pipelines-docs], you can notice the\n**triggered** word next to the pipelines that are re-run because a trigger\nwas initiated.\n\n\n![Pipeline\ntriggers](https://about.gitlab.com/images/blogimages/new-gitlab-docs-site/pipelines-triggers.png){:\n.shadow}\n\n\nHow we specifically use triggers for gitlab-docs is briefly described in the\n\n[project's readme][readme-triggers].\n\n\nWe also use a hack to symlink all `README.html` files into `index.html` so\nthat\n\nthey can be viewed without the extension. Notice how the following links\npoint\n\nto the same document:\n\n\n- \u003Chttps://docs.gitlab.com/ee/ci/yaml/index.html>\n\n- \u003Chttps://docs.gitlab.com/ee/ci/yaml/>\n\n\nThe line responsible for this is:\n\n\n```bash\n\nfor i in `find public -name README.html`; do ln -sf README.html $(dirname\n$i)/index.html; done\n\n```\n\n\nThe artifacts are made to [expire in] an hour since they are deployed to the\n\nGitLab Pages server, we don't need them lingering in GitLab forever.\n\n\nIt’s worth noting that GitLab Pages is a [GitLab Enterprise\nEdition](/stages-devops-lifecycle/)-only feature, but it’s also available\nfor free on GitLab.com.\n\n{: .alert .alert-info}\n\n\n## Conclusion\n\n\nHopefully this shows some GitLab's power and how having everything\nintegrated into one cohesive product simplifies one's workflow. If you have\na complex documentation site you’d like to put together from specific\ndirectories in multiple Git repositories, the process described above is the\nbest we've been able to come up with. If you have any ideas to make this\nsystem better, let us know!\n\n\nThe documentation website is [open\nsource](https://gitlab.com/gitlab-org/gitlab-docs), available under the MIT\nLicense. You’re welcome to take a look at it, submit a merge request, or\neven fork it to use it with your own project.\n\n\nThanks for reading, if you have any questions we’d be happy to answer them\nin the comments!\n\n\n\u003C!-- Cover image: https://unsplash.com/photos/G6G93jtU1vE -->\n\n\n[genrb]:\nhttps://gitlab.com/gitlab-com/doc-gitlab-com/blob/master/generate.rb\n\n[nanocyaml]:\nhttps://gitlab.com/gitlab-org/gitlab-docs/blob/30f13e6a81bf9baeda95204b5524c6abf980b1e5/nanoc.yaml#L101-149\n\n[Rakefile]:\nhttps://gitlab.com/gitlab-org/gitlab-docs/blob/30f13e6a81bf9baeda95204b5524c6abf980b1e5/Rakefile\n\n[md2html]:\nhttps://gitlab.com/gitlab-org/gitlab-docs/blob/30f13e6a81bf9baeda95204b5524c6abf980b1e5/lib/filters/markdown_to_html_ext.rb\n\n[redrules]:\nhttps://gitlab.com/gitlab-org/gitlab-docs/blob/30f13e6a81bf9baeda95204b5524c6abf980b1e5/Rules#L33-51\n\n[redcarpet]: https://github.com/vmg/redcarpet\n\n[allowfail]: https://docs.gitlab.com/ee/ci/yaml/#allow_failure\n\n[ciyaml]: https://docs.gitlab.com/ee/ci/yaml/\n\n[environments]:\nhttps://docs.gitlab.com/ee/ci/environments/index.html#dynamic-environments\n\n[pipeline]: https://gitlab.com/gitlab-org/gitlab-docs/pipelines/5266794\n\n[nginx-example]: https://gitlab.com/gitlab-examples/review-apps-nginx\n\n[radocs]: https://docs.gitlab.com/ee/ci/review_apps/index.html\n\n[shell executor]: https://docs.gitlab.com/runner/executors/shell.html\n\n[triggers]: https://docs.gitlab.com/ee/ci/triggers/\n\n[pipelines-docs]: https://gitlab.com/gitlab-org/gitlab-docs/pipelines\n\n[readme-triggers]:\nhttps://gitlab.com/gitlab-org/gitlab-docs/blob/master/README.md#deployment-process\n\n[gitstrategy]:\nhttps://docs.gitlab.com/ee/ci/runners/configure_runners.html#git-strategy\n\n[expire in]: https://docs.gitlab.com/ee/ci/yaml/#artifacts-expire_in\n\n[deps]: https://docs.gitlab.com/ee/ci/yaml/#dependencies\n\n[pages]: https://pages.gitlab.io\n\n[nanoc-filters]: https://nanoc.ws/doc/reference/filters/\n\n[rules]:\nhttps://gitlab.com/gitlab-org/gitlab-docs/blob/30f13e6a81bf9baeda95204b5524c6abf980b1e5/Rules\n\n[filtersdir]:\nhttps://gitlab.com/gitlab-org/gitlab-docs/tree/30f13e6a81bf9baeda95204b5524c6abf980b1e5/lib/filters\n\n[cache]: https://docs.gitlab.com/ee/ci/yaml/#cache\n\n[stages]: https://docs.gitlab.com/ee/ci/yaml/#stages\n\n[before_script]: https://docs.gitlab.com/ee/ci/yaml/#before_script\n","engineering",{"slug":23,"featured":6,"template":24},"building-a-new-gitlab-docs-site-with-nanoc-gitlab-ci-and-gitlab-pages","BlogPost","content:en-us:blog:building-a-new-gitlab-docs-site-with-nanoc-gitlab-ci-and-gitlab-pages.yml","yaml","Building A New Gitlab Docs Site With Nanoc Gitlab Ci And Gitlab Pages","content","en-us/blog/building-a-new-gitlab-docs-site-with-nanoc-gitlab-ci-and-gitlab-pages.yml","en-us/blog/building-a-new-gitlab-docs-site-with-nanoc-gitlab-ci-and-gitlab-pages","yml",{"_path":33,"_dir":34,"_draft":6,"_partial":6,"_locale":7,"data":35,"_id":457,"_type":26,"title":458,"_source":28,"_file":459,"_stem":460,"_extension":31},"/shared/en-us/main-navigation","en-us",{"logo":36,"freeTrial":41,"sales":46,"login":51,"items":56,"search":388,"minimal":419,"duo":438,"pricingDeployment":447},{"config":37},{"href":38,"dataGaName":39,"dataGaLocation":40},"/","gitlab logo","header",{"text":42,"config":43},"Get free trial",{"href":44,"dataGaName":45,"dataGaLocation":40},"https://gitlab.com/-/trial_registrations/new?glm_source=about.gitlab.com&glm_content=default-saas-trial/","free trial",{"text":47,"config":48},"Talk to sales",{"href":49,"dataGaName":50,"dataGaLocation":40},"/sales/","sales",{"text":52,"config":53},"Sign in",{"href":54,"dataGaName":55,"dataGaLocation":40},"https://gitlab.com/users/sign_in/","sign in",[57,101,199,204,309,369],{"text":58,"config":59,"cards":61,"footer":84},"Platform",{"dataNavLevelOne":60},"platform",[62,68,76],{"title":58,"description":63,"link":64},"The most comprehensive AI-powered DevSecOps Platform",{"text":65,"config":66},"Explore our Platform",{"href":67,"dataGaName":60,"dataGaLocation":40},"/platform/",{"title":69,"description":70,"link":71},"GitLab Duo (AI)","Build software faster with AI at every stage of development",{"text":72,"config":73},"Meet GitLab Duo",{"href":74,"dataGaName":75,"dataGaLocation":40},"/gitlab-duo/","gitlab duo ai",{"title":77,"description":78,"link":79},"Why GitLab","10 reasons why Enterprises choose GitLab",{"text":80,"config":81},"Learn more",{"href":82,"dataGaName":83,"dataGaLocation":40},"/why-gitlab/","why gitlab",{"title":85,"items":86},"Get started with",[87,92,97],{"text":88,"config":89},"Platform Engineering",{"href":90,"dataGaName":91,"dataGaLocation":40},"/solutions/platform-engineering/","platform engineering",{"text":93,"config":94},"Developer Experience",{"href":95,"dataGaName":96,"dataGaLocation":40},"/developer-experience/","Developer experience",{"text":98,"config":99},"MLOps",{"href":100,"dataGaName":98,"dataGaLocation":40},"/topics/devops/the-role-of-ai-in-devops/",{"text":102,"left":103,"config":104,"link":106,"lists":110,"footer":181},"Product",true,{"dataNavLevelOne":105},"solutions",{"text":107,"config":108},"View all Solutions",{"href":109,"dataGaName":105,"dataGaLocation":40},"/solutions/",[111,136,160],{"title":112,"description":113,"link":114,"items":119},"Automation","CI/CD and automation to accelerate deployment",{"config":115},{"icon":116,"href":117,"dataGaName":118,"dataGaLocation":40},"AutomatedCodeAlt","/solutions/delivery-automation/","automated software delivery",[120,124,128,132],{"text":121,"config":122},"CI/CD",{"href":123,"dataGaLocation":40,"dataGaName":121},"/solutions/continuous-integration/",{"text":125,"config":126},"AI-Assisted Development",{"href":74,"dataGaLocation":40,"dataGaName":127},"AI assisted development",{"text":129,"config":130},"Source Code Management",{"href":131,"dataGaLocation":40,"dataGaName":129},"/solutions/source-code-management/",{"text":133,"config":134},"Automated Software Delivery",{"href":117,"dataGaLocation":40,"dataGaName":135},"Automated software delivery",{"title":137,"description":138,"link":139,"items":144},"Security","Deliver code faster without compromising security",{"config":140},{"href":141,"dataGaName":142,"dataGaLocation":40,"icon":143},"/solutions/security-compliance/","security and compliance","ShieldCheckLight",[145,150,155],{"text":146,"config":147},"Application Security Testing",{"href":148,"dataGaName":149,"dataGaLocation":40},"/solutions/application-security-testing/","Application security testing",{"text":151,"config":152},"Software Supply Chain Security",{"href":153,"dataGaLocation":40,"dataGaName":154},"/solutions/supply-chain/","Software supply chain security",{"text":156,"config":157},"Software Compliance",{"href":158,"dataGaName":159,"dataGaLocation":40},"/solutions/software-compliance/","software compliance",{"title":161,"link":162,"items":167},"Measurement",{"config":163},{"icon":164,"href":165,"dataGaName":166,"dataGaLocation":40},"DigitalTransformation","/solutions/visibility-measurement/","visibility and measurement",[168,172,176],{"text":169,"config":170},"Visibility & Measurement",{"href":165,"dataGaLocation":40,"dataGaName":171},"Visibility and Measurement",{"text":173,"config":174},"Value Stream Management",{"href":175,"dataGaLocation":40,"dataGaName":173},"/solutions/value-stream-management/",{"text":177,"config":178},"Analytics & Insights",{"href":179,"dataGaLocation":40,"dataGaName":180},"/solutions/analytics-and-insights/","Analytics and insights",{"title":182,"items":183},"GitLab for",[184,189,194],{"text":185,"config":186},"Enterprise",{"href":187,"dataGaLocation":40,"dataGaName":188},"/enterprise/","enterprise",{"text":190,"config":191},"Small Business",{"href":192,"dataGaLocation":40,"dataGaName":193},"/small-business/","small business",{"text":195,"config":196},"Public Sector",{"href":197,"dataGaLocation":40,"dataGaName":198},"/solutions/public-sector/","public sector",{"text":200,"config":201},"Pricing",{"href":202,"dataGaName":203,"dataGaLocation":40,"dataNavLevelOne":203},"/pricing/","pricing",{"text":205,"config":206,"link":208,"lists":212,"feature":296},"Resources",{"dataNavLevelOne":207},"resources",{"text":209,"config":210},"View all resources",{"href":211,"dataGaName":207,"dataGaLocation":40},"/resources/",[213,246,268],{"title":214,"items":215},"Getting started",[216,221,226,231,236,241],{"text":217,"config":218},"Install",{"href":219,"dataGaName":220,"dataGaLocation":40},"/install/","install",{"text":222,"config":223},"Quick start guides",{"href":224,"dataGaName":225,"dataGaLocation":40},"/get-started/","quick setup checklists",{"text":227,"config":228},"Learn",{"href":229,"dataGaLocation":40,"dataGaName":230},"https://university.gitlab.com/","learn",{"text":232,"config":233},"Product documentation",{"href":234,"dataGaName":235,"dataGaLocation":40},"https://docs.gitlab.com/","product documentation",{"text":237,"config":238},"Best practice videos",{"href":239,"dataGaName":240,"dataGaLocation":40},"/getting-started-videos/","best practice videos",{"text":242,"config":243},"Integrations",{"href":244,"dataGaName":245,"dataGaLocation":40},"/integrations/","integrations",{"title":247,"items":248},"Discover",[249,254,258,263],{"text":250,"config":251},"Customer success stories",{"href":252,"dataGaName":253,"dataGaLocation":40},"/customers/","customer success stories",{"text":255,"config":256},"Blog",{"href":257,"dataGaName":5,"dataGaLocation":40},"/blog/",{"text":259,"config":260},"Remote",{"href":261,"dataGaName":262,"dataGaLocation":40},"https://handbook.gitlab.com/handbook/company/culture/all-remote/","remote",{"text":264,"config":265},"TeamOps",{"href":266,"dataGaName":267,"dataGaLocation":40},"/teamops/","teamops",{"title":269,"items":270},"Connect",[271,276,281,286,291],{"text":272,"config":273},"GitLab Services",{"href":274,"dataGaName":275,"dataGaLocation":40},"/services/","services",{"text":277,"config":278},"Community",{"href":279,"dataGaName":280,"dataGaLocation":40},"/community/","community",{"text":282,"config":283},"Forum",{"href":284,"dataGaName":285,"dataGaLocation":40},"https://forum.gitlab.com/","forum",{"text":287,"config":288},"Events",{"href":289,"dataGaName":290,"dataGaLocation":40},"/events/","events",{"text":292,"config":293},"Partners",{"href":294,"dataGaName":295,"dataGaLocation":40},"/partners/","partners",{"backgroundColor":297,"textColor":298,"text":299,"image":300,"link":304},"#2f2a6b","#fff","Insights for the future of software development",{"altText":301,"config":302},"the source promo card",{"src":303},"https://res.cloudinary.com/about-gitlab-com/image/upload/v1758208064/dzl0dbift9xdizyelkk4.svg",{"text":305,"config":306},"Read the latest",{"href":307,"dataGaName":308,"dataGaLocation":40},"/the-source/","the source",{"text":310,"config":311,"lists":313},"Company",{"dataNavLevelOne":312},"company",[314],{"items":315},[316,321,327,329,334,339,344,349,354,359,364],{"text":317,"config":318},"About",{"href":319,"dataGaName":320,"dataGaLocation":40},"/company/","about",{"text":322,"config":323,"footerGa":326},"Jobs",{"href":324,"dataGaName":325,"dataGaLocation":40},"/jobs/","jobs",{"dataGaName":325},{"text":287,"config":328},{"href":289,"dataGaName":290,"dataGaLocation":40},{"text":330,"config":331},"Leadership",{"href":332,"dataGaName":333,"dataGaLocation":40},"/company/team/e-group/","leadership",{"text":335,"config":336},"Team",{"href":337,"dataGaName":338,"dataGaLocation":40},"/company/team/","team",{"text":340,"config":341},"Handbook",{"href":342,"dataGaName":343,"dataGaLocation":40},"https://handbook.gitlab.com/","handbook",{"text":345,"config":346},"Investor relations",{"href":347,"dataGaName":348,"dataGaLocation":40},"https://ir.gitlab.com/","investor relations",{"text":350,"config":351},"Trust Center",{"href":352,"dataGaName":353,"dataGaLocation":40},"/security/","trust center",{"text":355,"config":356},"AI Transparency Center",{"href":357,"dataGaName":358,"dataGaLocation":40},"/ai-transparency-center/","ai transparency center",{"text":360,"config":361},"Newsletter",{"href":362,"dataGaName":363,"dataGaLocation":40},"/company/contact/","newsletter",{"text":365,"config":366},"Press",{"href":367,"dataGaName":368,"dataGaLocation":40},"/press/","press",{"text":370,"config":371,"lists":372},"Contact us",{"dataNavLevelOne":312},[373],{"items":374},[375,378,383],{"text":47,"config":376},{"href":49,"dataGaName":377,"dataGaLocation":40},"talk to sales",{"text":379,"config":380},"Get help",{"href":381,"dataGaName":382,"dataGaLocation":40},"/support/","get help",{"text":384,"config":385},"Customer portal",{"href":386,"dataGaName":387,"dataGaLocation":40},"https://customers.gitlab.com/customers/sign_in/","customer portal",{"close":389,"login":390,"suggestions":397},"Close",{"text":391,"link":392},"To search repositories and projects, login to",{"text":393,"config":394},"gitlab.com",{"href":54,"dataGaName":395,"dataGaLocation":396},"search login","search",{"text":398,"default":399},"Suggestions",[400,402,406,408,412,416],{"text":69,"config":401},{"href":74,"dataGaName":69,"dataGaLocation":396},{"text":403,"config":404},"Code Suggestions (AI)",{"href":405,"dataGaName":403,"dataGaLocation":396},"/solutions/code-suggestions/",{"text":121,"config":407},{"href":123,"dataGaName":121,"dataGaLocation":396},{"text":409,"config":410},"GitLab on AWS",{"href":411,"dataGaName":409,"dataGaLocation":396},"/partners/technology-partners/aws/",{"text":413,"config":414},"GitLab on Google Cloud",{"href":415,"dataGaName":413,"dataGaLocation":396},"/partners/technology-partners/google-cloud-platform/",{"text":417,"config":418},"Why GitLab?",{"href":82,"dataGaName":417,"dataGaLocation":396},{"freeTrial":420,"mobileIcon":425,"desktopIcon":430,"secondaryButton":433},{"text":421,"config":422},"Start free trial",{"href":423,"dataGaName":45,"dataGaLocation":424},"https://gitlab.com/-/trials/new/","nav",{"altText":426,"config":427},"Gitlab Icon",{"src":428,"dataGaName":429,"dataGaLocation":424},"https://res.cloudinary.com/about-gitlab-com/image/upload/v1758203874/jypbw1jx72aexsoohd7x.svg","gitlab icon",{"altText":426,"config":431},{"src":432,"dataGaName":429,"dataGaLocation":424},"https://res.cloudinary.com/about-gitlab-com/image/upload/v1758203875/gs4c8p8opsgvflgkswz9.svg",{"text":434,"config":435},"Get Started",{"href":436,"dataGaName":437,"dataGaLocation":424},"https://gitlab.com/-/trial_registrations/new?glm_source=about.gitlab.com/compare/gitlab-vs-github/","get started",{"freeTrial":439,"mobileIcon":443,"desktopIcon":445},{"text":440,"config":441},"Learn more about GitLab Duo",{"href":74,"dataGaName":442,"dataGaLocation":424},"gitlab duo",{"altText":426,"config":444},{"src":428,"dataGaName":429,"dataGaLocation":424},{"altText":426,"config":446},{"src":432,"dataGaName":429,"dataGaLocation":424},{"freeTrial":448,"mobileIcon":453,"desktopIcon":455},{"text":449,"config":450},"Back to pricing",{"href":202,"dataGaName":451,"dataGaLocation":424,"icon":452},"back to pricing","GoBack",{"altText":426,"config":454},{"src":428,"dataGaName":429,"dataGaLocation":424},{"altText":426,"config":456},{"src":432,"dataGaName":429,"dataGaLocation":424},"content:shared:en-us:main-navigation.yml","Main Navigation","shared/en-us/main-navigation.yml","shared/en-us/main-navigation",{"_path":462,"_dir":34,"_draft":6,"_partial":6,"_locale":7,"title":463,"button":464,"image":469,"config":473,"_id":475,"_type":26,"_source":28,"_file":476,"_stem":477,"_extension":31},"/shared/en-us/banner","is now in public beta!",{"text":465,"config":466},"Try the Beta",{"href":467,"dataGaName":468,"dataGaLocation":40},"/gitlab-duo/agent-platform/","duo banner",{"altText":470,"config":471},"GitLab Duo Agent Platform",{"src":472},"https://res.cloudinary.com/about-gitlab-com/image/upload/v1753720689/somrf9zaunk0xlt7ne4x.svg",{"layout":474},"release","content:shared:en-us:banner.yml","shared/en-us/banner.yml","shared/en-us/banner",{"_path":479,"_dir":34,"_draft":6,"_partial":6,"_locale":7,"data":480,"_id":684,"_type":26,"title":685,"_source":28,"_file":686,"_stem":687,"_extension":31},"/shared/en-us/main-footer",{"text":481,"source":482,"edit":488,"contribute":493,"config":498,"items":503,"minimal":676},"Git is a trademark of Software Freedom Conservancy and our use of 'GitLab' is under license",{"text":483,"config":484},"View page source",{"href":485,"dataGaName":486,"dataGaLocation":487},"https://gitlab.com/gitlab-com/marketing/digital-experience/about-gitlab-com/","page source","footer",{"text":489,"config":490},"Edit this page",{"href":491,"dataGaName":492,"dataGaLocation":487},"https://gitlab.com/gitlab-com/marketing/digital-experience/about-gitlab-com/-/blob/main/content/","web ide",{"text":494,"config":495},"Please contribute",{"href":496,"dataGaName":497,"dataGaLocation":487},"https://gitlab.com/gitlab-com/marketing/digital-experience/about-gitlab-com/-/blob/main/CONTRIBUTING.md/","please contribute",{"twitter":499,"facebook":500,"youtube":501,"linkedin":502},"https://twitter.com/gitlab","https://www.facebook.com/gitlab","https://www.youtube.com/channel/UCnMGQ8QHMAnVIsI3xJrihhg","https://www.linkedin.com/company/gitlab-com",[504,527,583,612,646],{"title":58,"links":505,"subMenu":510},[506],{"text":507,"config":508},"DevSecOps platform",{"href":67,"dataGaName":509,"dataGaLocation":487},"devsecops platform",[511],{"title":200,"links":512},[513,517,522],{"text":514,"config":515},"View plans",{"href":202,"dataGaName":516,"dataGaLocation":487},"view plans",{"text":518,"config":519},"Why Premium?",{"href":520,"dataGaName":521,"dataGaLocation":487},"/pricing/premium/","why premium",{"text":523,"config":524},"Why Ultimate?",{"href":525,"dataGaName":526,"dataGaLocation":487},"/pricing/ultimate/","why ultimate",{"title":528,"links":529},"Solutions",[530,535,537,539,544,549,553,556,560,565,567,570,573,578],{"text":531,"config":532},"Digital transformation",{"href":533,"dataGaName":534,"dataGaLocation":487},"/topics/digital-transformation/","digital transformation",{"text":146,"config":536},{"href":148,"dataGaName":146,"dataGaLocation":487},{"text":135,"config":538},{"href":117,"dataGaName":118,"dataGaLocation":487},{"text":540,"config":541},"Agile development",{"href":542,"dataGaName":543,"dataGaLocation":487},"/solutions/agile-delivery/","agile delivery",{"text":545,"config":546},"Cloud transformation",{"href":547,"dataGaName":548,"dataGaLocation":487},"/topics/cloud-native/","cloud transformation",{"text":550,"config":551},"SCM",{"href":131,"dataGaName":552,"dataGaLocation":487},"source code management",{"text":121,"config":554},{"href":123,"dataGaName":555,"dataGaLocation":487},"continuous integration & delivery",{"text":557,"config":558},"Value stream management",{"href":175,"dataGaName":559,"dataGaLocation":487},"value stream management",{"text":561,"config":562},"GitOps",{"href":563,"dataGaName":564,"dataGaLocation":487},"/solutions/gitops/","gitops",{"text":185,"config":566},{"href":187,"dataGaName":188,"dataGaLocation":487},{"text":568,"config":569},"Small business",{"href":192,"dataGaName":193,"dataGaLocation":487},{"text":571,"config":572},"Public sector",{"href":197,"dataGaName":198,"dataGaLocation":487},{"text":574,"config":575},"Education",{"href":576,"dataGaName":577,"dataGaLocation":487},"/solutions/education/","education",{"text":579,"config":580},"Financial services",{"href":581,"dataGaName":582,"dataGaLocation":487},"/solutions/finance/","financial services",{"title":205,"links":584},[585,587,589,591,594,596,598,600,602,604,606,608,610],{"text":217,"config":586},{"href":219,"dataGaName":220,"dataGaLocation":487},{"text":222,"config":588},{"href":224,"dataGaName":225,"dataGaLocation":487},{"text":227,"config":590},{"href":229,"dataGaName":230,"dataGaLocation":487},{"text":232,"config":592},{"href":234,"dataGaName":593,"dataGaLocation":487},"docs",{"text":255,"config":595},{"href":257,"dataGaName":5,"dataGaLocation":487},{"text":250,"config":597},{"href":252,"dataGaName":253,"dataGaLocation":487},{"text":259,"config":599},{"href":261,"dataGaName":262,"dataGaLocation":487},{"text":272,"config":601},{"href":274,"dataGaName":275,"dataGaLocation":487},{"text":264,"config":603},{"href":266,"dataGaName":267,"dataGaLocation":487},{"text":277,"config":605},{"href":279,"dataGaName":280,"dataGaLocation":487},{"text":282,"config":607},{"href":284,"dataGaName":285,"dataGaLocation":487},{"text":287,"config":609},{"href":289,"dataGaName":290,"dataGaLocation":487},{"text":292,"config":611},{"href":294,"dataGaName":295,"dataGaLocation":487},{"title":310,"links":613},[614,616,618,620,622,624,626,630,635,637,639,641],{"text":317,"config":615},{"href":319,"dataGaName":312,"dataGaLocation":487},{"text":322,"config":617},{"href":324,"dataGaName":325,"dataGaLocation":487},{"text":330,"config":619},{"href":332,"dataGaName":333,"dataGaLocation":487},{"text":335,"config":621},{"href":337,"dataGaName":338,"dataGaLocation":487},{"text":340,"config":623},{"href":342,"dataGaName":343,"dataGaLocation":487},{"text":345,"config":625},{"href":347,"dataGaName":348,"dataGaLocation":487},{"text":627,"config":628},"Sustainability",{"href":629,"dataGaName":627,"dataGaLocation":487},"/sustainability/",{"text":631,"config":632},"Diversity, inclusion and belonging (DIB)",{"href":633,"dataGaName":634,"dataGaLocation":487},"/diversity-inclusion-belonging/","Diversity, inclusion and belonging",{"text":350,"config":636},{"href":352,"dataGaName":353,"dataGaLocation":487},{"text":360,"config":638},{"href":362,"dataGaName":363,"dataGaLocation":487},{"text":365,"config":640},{"href":367,"dataGaName":368,"dataGaLocation":487},{"text":642,"config":643},"Modern Slavery Transparency Statement",{"href":644,"dataGaName":645,"dataGaLocation":487},"https://handbook.gitlab.com/handbook/legal/modern-slavery-act-transparency-statement/","modern slavery transparency statement",{"title":647,"links":648},"Contact Us",[649,652,654,656,661,666,671],{"text":650,"config":651},"Contact an expert",{"href":49,"dataGaName":50,"dataGaLocation":487},{"text":379,"config":653},{"href":381,"dataGaName":382,"dataGaLocation":487},{"text":384,"config":655},{"href":386,"dataGaName":387,"dataGaLocation":487},{"text":657,"config":658},"Status",{"href":659,"dataGaName":660,"dataGaLocation":487},"https://status.gitlab.com/","status",{"text":662,"config":663},"Terms of use",{"href":664,"dataGaName":665,"dataGaLocation":487},"/terms/","terms of use",{"text":667,"config":668},"Privacy statement",{"href":669,"dataGaName":670,"dataGaLocation":487},"/privacy/","privacy statement",{"text":672,"config":673},"Cookie preferences",{"dataGaName":674,"dataGaLocation":487,"id":675,"isOneTrustButton":103},"cookie preferences","ot-sdk-btn",{"items":677},[678,680,682],{"text":662,"config":679},{"href":664,"dataGaName":665,"dataGaLocation":487},{"text":667,"config":681},{"href":669,"dataGaName":670,"dataGaLocation":487},{"text":672,"config":683},{"dataGaName":674,"dataGaLocation":487,"id":675,"isOneTrustButton":103},"content:shared:en-us:main-footer.yml","Main Footer","shared/en-us/main-footer.yml","shared/en-us/main-footer",[689],{"_path":690,"_dir":691,"_draft":6,"_partial":6,"_locale":7,"content":692,"config":696,"_id":698,"_type":26,"title":18,"_source":28,"_file":699,"_stem":700,"_extension":31},"/en-us/blog/authors/connor-shea","authors",{"name":18,"config":693},{"headshot":694,"ctfId":695},"https://res.cloudinary.com/about-gitlab-com/image/upload/v1749659488/Blog/Author%20Headshots/gitlab-logo-extra-whitespace.png","Connor-Shea",{"template":697},"BlogAuthor","content:en-us:blog:authors:connor-shea.yml","en-us/blog/authors/connor-shea.yml","en-us/blog/authors/connor-shea",{"_path":702,"_dir":34,"_draft":6,"_partial":6,"_locale":7,"header":703,"eyebrow":704,"blurb":705,"button":706,"secondaryButton":710,"_id":712,"_type":26,"title":713,"_source":28,"_file":714,"_stem":715,"_extension":31},"/shared/en-us/next-steps","Start shipping better software faster","50%+ of the Fortune 100 trust GitLab","See what your team can do with the intelligent\n\n\nDevSecOps platform.\n",{"text":42,"config":707},{"href":708,"dataGaName":45,"dataGaLocation":709},"https://gitlab.com/-/trial_registrations/new?glm_content=default-saas-trial&glm_source=about.gitlab.com/","feature",{"text":47,"config":711},{"href":49,"dataGaName":50,"dataGaLocation":709},"content:shared:en-us:next-steps.yml","Next Steps","shared/en-us/next-steps.yml","shared/en-us/next-steps",1758326223235]