With autosectionlabel_maxdepth = 1 every page's H1 becomes a global
label, so pages sharing a generic title collide. The blanket
'WARNING: duplicate label' entry in allowed_warnings hid all of them.
Fix the remaining 45 collisions, then drop the entry so new ones fail
the build:
- Give generic page titles a component-specific name: 'Testing',
'Debugging', 'Preferences', 'Contributing', 'Telemetry',
'Architecture overview', 'Settings', 'Metrics' and the DevTools user
docs' 'How to', 'UI Tour' and 'Search'.
- The mobile RFCs used one H1 per section, so every RFC redefined
'Summary', 'Motivation' and friends. Give each a single H1 title and
demote the section headings.
- Prefix four explicit targets that collided with another page's H1:
introduction, plhashtable, preferences and mochitests.
- docs/contributing/build/supported.md only did a MyST include of
build/docs/supported-configurations.md, which redefined every label
in it. Drop the page and redirect to the included one instead.
A clean ./mach doc goes from 1385 to 1257 warnings and from 59
duplicate labels to 0, with no new undefined labels or broken
cross-references.
Differential Revision: https://phabricator.services.mozilla.com/D315888
Sylvestre Ledru
fe90d22103
