Skip to content

Add versions

Update

Closing this in favor of an epic gitlab-com&8 (closed)


This will be necessary for replacing the Help section of the Rails app (https://gitlab.com/gitlab-org/gitlab-ce/issues/18739).

Decisions:

  • Version-less URL should built from master
  • master is deployed under /
  • Show comments only for version-less URL

Infrastructure and site building

Inspired from how Docker does versioning https://github.com/docker/docker.github.io/tree/publish-tools.

Backend

  • The "Edit on GitLab.com" filter will need to be updated (use only on the master branches)
  • Handle robots.txt to exclude the versioned pages
  • Handle the sitemap.xml for each version

Frontend

Search

Extras

Test locally

You'll need Docker installed, then run:

docker run -it --rm -p 4000:4000 registry.gitlab.com/gitlab-com/gitlab-docs:latest

Visit http://localhost:4000/archives/

Edited by Achilleas Pipinellis