Configure the GitLab Handbook to use the Static Site Editor
Problem to solve
The GitLab Handbook is a prime candidate for making edits using the Static Site Editor. Its structure, however, is a little more complex than the basic statically-generated site.
Proposal
The GitLab handbook project should be configured to use the Static Site Editor
Details
Many of the pages in the GitLab handbook are .html.md.erb
even if they don't contain any Ruby code. The Static Site Editor will need to be updated to open this page type.
Note This issue is only for the configuration of the projects. There is another issue for surfacing the functionality to users in the handbook pages themselves.
Success criteria
- A user can manually paste a properly-formatted link from the GitLab Handbook project and open a page in the Static Site Editor
- A user can make an edit and accompanying merge request to a GitLab Handbook page using the Static Site Editor
Implementation tasks
-
Allow opening files with erb
extension on the Static Site Editor backend - #223171 (closed) -
Create a Static Site Editor configuration file in www-gitlab-com frontend -
Create an "Edit on the Static Site Editor" widget that we can include in a page frontend -
Update documentation to remove statement that describes erb
limitation documentation