Use a static site generator as a middleware for the internal help page
Long story short, we now have to maintain 2 different doc pages: /help
and docs.gitlab.com. On docs.gitlab.com we use a hacky script to convert markdown to html using pandoc. Ideally we want to move to an SSG like jekyll or nanoc for docs.gitlab.com, so if we go down that path why not also use the same tool for /help
?
Having an SSG would help us build things like having different translations, different versions, etc.
Caveats:
- On docs.gitlab.com we also host docs for omnibus and the runner.
- Something else I'm missing...
Relevant issues:
- https://gitlab.com/gitlab-org/gitlab-ce/issues/19996
- https://gitlab.com/gitlab-org/gitlab-ce/issues/19927
- https://gitlab.com/gitlab-org/gitlab-ce/issues?scope=all&sort=id_desc&state=opened&utf8=%E2%9C%93&label_name%5B%5D=help+page&label-name=
- https://gitlab.com/gitlab-com/doc-gitlab-com/issues/35
cc @connorshea @dblessing @virtuacreative @DouweM @rspeicher