Skip to content

[meta] Refactor Pages docs

Our Pages docs are very complete, we have a lot of good content there. But it needs to be reorganized to make it onboarding Pages easier and simpler.

Index: https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/15411

  • Refactor Pages index: our Pages index was the first one we created, and it's confusing the way it was structured. Let's begin with something really simple (minimum requirements and steps), then gather additional info afterward.
  • The first how-to blog post about it is also redundant now that we have our user guides. Mention that the process is outdated/deprecated.
  • The Let's Encrypt post is outdated, mention that on the index.
  • Add a brief description of each link
  • Leave informative posts to the end (Pages IP, Pages coming to CE, etc)

Other docs:

Notes from Sid/Job: => https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/17188

  • Choose your SSG template => from where?
  • Fork a project from the Pages group => how do I fork?
  • Remove the fork relationship by navigating to your Project's Settings > Edit Project => I spend 5 minutes to find this
  • Enable Shared Runners for your fork: navigate to your Project's Settings > Pipelines => outdated

cc/ @axil @JobV

Edited by Marcia Ramos