Create a website with some document engine
We are starting to use more and more RestructuredText documents for protocol extensions, and the README etc. are in ReST already as well. GitLab showing ReST files as rendered documents has worked ok'ish so far, but now that I want to use math with the CM&HDR documentation, it's no longer sufficient. GitLab does not render math elements.
The reason I originally suggested using ReST is that Weston is using ReST for its documentation already and it uses Sphinx as the engine. Weston also includes documentation from code comments with varying degrees of success. You can check the Weston documentation web site. You can also see Weston's CI directives for generating the website automatically. Unfortunately Sphinx does not integrate well with Meson, but it's the best we could find for Weston when we looked. There are several issues with it still: weston#308, weston#315, weston#316, weston#365.
What is not covered by the Weston Sphinx setup is generating documentation from protocol XML, which would be really nice for both wayland-protocols and wayland. Wayland currently uses an unholy construction of Doxygen, DocBook and hand-crafted XSLT (!) to create the Wayland book, which is not automatically published. Unlike Wayland, wayland-protocols probably doesn't need to generate documentation from code comments.
Additionally, wayland-protocols wants to generate the adoption website (Section 3) from some sort of database'ish.
We have some precedent with Sphinx, so I would suggest attempting with it first. My immediate need is to just get HTML generated from all the ReST files with proper handling of mathematical formulas, but how to generate documentation from Wayland XML is also important in the long run.
Once wayland-protocols has perfected the documentation generation from Wayland XML files, then maybe Wayland itself can start using that and generating documentation from code comments and move the Wayland book into Gitlab pages instead of needing to copy it into wayland-web repository.