Versioned documentation for go-webengine, built with
Hugo and this fleet's
Hextra fork. Published to the
gh-pages branch and served at https://go-webengine.github.io/docs/.
⛔ What this replaced was MkDocs Material plus mike, which needed a Python
toolchain, a requirements.txt and a pip install in CI to render a static
site for a pure-Go organisation.
git submodule update --init --recursive # themes/hextra, pinned at a release tag
hugo server # http://localhost:1313Each documented version is its own build under /docs/<version>/, and
/docs/latest/ follows the newest — which is what mike did before. The version
comes from params.docs.version in hugo.yaml: set it to the release the pages
describe (v0.16.0 → /docs/0.16/), or leave it at main while no release is
tagged. The docs workflow reads it, builds with that --baseURL, and replaces
only that version's path.
⛔ The build runs with --panicOnWarning, so a link to a page that is not there
fails the lane instead of 404ing for a reader.