Re: [PATCH] docs: set canonical base URL for HTML output
From: Rito Rhymes
Date: Mon Mar 23 2026 - 15:40:32 EST
To be clear:
canonical URL + local build = useless
canonical URL set by env var + official published build = source
authority support
hardcoded canonical URL in the source tree + mirror deployments =
1. Benign mirror benefit
Mirrors inherit a source-authority-supporting default without
needing to think about it or configure anything themselves.
2. Adversarial / careless mirror mitigation
Anyone who does not want to preserve that signal must take an
extra step to remove or override it, adding at least some
friction to careless or hostile reuse.
Hardcoding it is simpler, safer and more effective because it makes
preservation of the preferred source the path of least resistance,
requires any departure from it to be explicit, and costs local builds
very little without side effects.
Rito