Sylvestre Ledru e39f065982 Bug 2060006 - Point documentation cross-references at the source document instead of the rendered .html. r=necko-reviewers,geckoview-reviewers,releng-reviewers,profiler-reviewers,migration-reviewers,urlbar-reviewers,Sasha,janerik,canova,ohall,bhearsum,valentin ...

111 MyST cross-references used the rendered .html path, which resolves
to nothing, so Sphinx reported 'cross-reference target not found' for
each of them.

Most were mechanical (foo.html -> foo.md). Nine targeted documents that
had moved in the meantime:

 - the eslint-plugin-mozilla valid-ci-uses and valid-services-property
   rules moved under rules/
 - /devtools/tests/debugging-intermittents moved to
   /testing/debugging-intermittents/
 - /tools/lint/linters/rstlinter moved to
   /code-quality/lint/linters/rstlinter
 - the telemetry collection/scalars and collection/events pages moved
   under obsolete/collection/
 - taskcluster/optimization is a directory now, so the link needs
   optimization/index
 - /security/nss/index and /python/marionette_driver are still .rst

report-gecko-telemetry-in-glean.md linked to glean/user/migration.html,
which does not exist under that name; point it at the Glean user index
instead.

A clean ./mach doc goes from 1257 to 1037 warnings and the 111 .html
cross-reference failures drop to 0, with no new undefined labels.

Differential Revision: https://phabricator.services.mozilla.com/D315898

2026-08-06 00:06:34 +00:00

..

artifact_builds.md

…

building_mobile_firefox.md

…

working_with_esr_115.md

…