[GRASS-git] [OSGeo/grass] 0163d2: docs: noindex development manuals so they defer to...

[Corey White]

  Branch: refs/heads/main
  Home:   https://github.com/OSGeo/grass
  Commit: 0163d24d64b3421409a4abd254da0361522c593c
      https://github.com/OSGeo/grass/commit/0163d24d64b3421409a4abd254da0361522c593c
  Author: Corey White <smortopahri at gmail.com>
  Date:   2026-07-25 (Sat, 25 Jul 2026)

  Changed paths:
    M .github/workflows/documentation.yml
    M man/Makefile
    M man/mkdocs/mkdocs.yml
    A man/mkdocs/overrides/main.html
    M python/grass/docs/_templates/layout.html.template
    M python/grass/docs/conf.py

  Log Message:
  -----------
  docs: noindex development manuals so they defer to grass-stable (#7772)

* docs: noindex development manuals so they defer to grass-stable

Dev builds (VERSION micro ends in 'dev') publish under grass-devel/grass86 with
pages near-identical to grass-stable. They all canonicalize to grass-stable
(see #5935), but dev-only pages have no stable equivalent to canonicalize to, so
canonical alone can leave them indexed. Emit 'noindex, follow' on dev builds for
both generators:

- MkDocs: new overrides/main.html gated on extra.noindex, fed by GRASS_DOCS_NOINDEX
  which documentation.yml sets to true when MICRO ends in 'dev'.
- Sphinx: conf.py sets grass_noindex from the version and passes it via html_context
  to layout.html.template.

Stable and release builds leave the flag off and stay indexable.

* docs: fix MkDocs noindex flag on dev builds

mkdocs !ENV coerces the value to a boolean, so the == "true" test never matched.

* man: install mkdocs overrides/main.html into the docs dir

The build copies mkdocs files individually, so the new override was missing
from MKDOCS_DIR and dev pages got no noindex.



To unsubscribe from these emails, change your notification settings at https://github.com/OSGeo/grass/settings/notifications