Peter has been working hard to fix up the glitches when converting from sphinx rst files to mkdocs markdown.
I have updated GSIP 221 · geoserver/geoserver Wiki · GitHub proposal to indicate changing over alongside GeoServer 3.0. It makes sense to convert main as we need to through and review each page and update screen snaps for GeoServer 3.x.
Short term we would publish to OSGeo, sending a zip of the docs over using the build server.
However mkdocs works well with gh-pages and includes a version selector. Which could also be used to switch to historical versions also:
versions.json
3.1/
latest/
3.0/
stable/
2.28.x/
maintenance/
2.27.x/
2.26.x/
If we wish to convert 2.28.x (and have the historical branches in mkdocs) … we need to do some QA, or accept some glitches (primarily this has been with tables).
Preview URL: GeoServer Documentation Guide
Available Documentation:
- http://geoserver.org/geoserver/en/docguide/ compare to Home — GeoServer 3.0 Documentation Guide
- http://geoserver.org/geoserver/en/developer/ compare to GeoServer Developer Manual — GeoServer 3.0 Developer Manual
- http://geoserver.org/geoserver/en/user/ compare to GeoServer User Manual — GeoServer 2.28.0 User Manual
Example version selector (converting historical branches): latest | stable | 3.12.