Markup and math
Right now the docs are in ReST, for which Gitlab has some support for rendering it formatted when showing files. I would like to be able to use proper mathematical notation, but ISTR that was not really possible with Gitlab parsed ReST.
Either we would need to switch to Gitlab flavored Markdown (example), or use a tool in CI to publish formatted documentation. Or, put all equations in images manually, but I think that does not really work out.
Which way should we go?
Setting up tooling in CI is a one-time(?) effort after we agree on what tooling to use, which may be a journey of its own.
Math in Gitlab flavored Markdown OTOH is rendered in the browser with Javascript. Not all people accept Javascript, but my bigger concern is that lots of math can make a page really heavy to render, causing some equations to time out.