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