Files
Sylvestre Ledru fe90d22103 Bug 2060038 - Stop allowing duplicate documentation labels. r=firefox-source-docs-reviewers,geckoview-reviewers,devtools-reviewers,places-reviewers,profiler-reviewers,android-reviewers,Sasha,janerik,nchevobbe,canova,ohall,ahal
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
2026-08-06 00:06:28 +00:00

1.4 KiB

Debugger how-tos

These articles describe how to use the debugger.

  • {doc}Access debugging in add-ons <access_debugging_in_add-ons/index>
  • {doc}Breaking on exceptions <breaking_on_exceptions/index>
  • {doc}Debug eval sources <debug_eval_sources/index>
  • {doc}Disable breakpoints <disable_breakpoints/index>
  • {doc}Highlight and inspect DOM nodes <highlight_and_inspect_dom_nodes/index>
  • {doc}Ignoring sources <ignoring_sources/index>
  • {doc}Open the debugger <open_the_debugger/index>
  • {doc}Pretty-print a minified file <pretty-print_a_minified_file/index>
  • {doc}Search <search/index>
  • {doc}Set a breakpoint <set_a_breakpoint/index>
  • {doc}Set a conditional breakpoint <set_a_conditional_breakpoint/index>
  • {doc}Set watch expressions <set_watch_expressions/index>
  • {doc}Step through code <step_through_code/index>
  • {doc}Use a source map <use_a_source_map/index>
  • {doc}Use watchpoints <use_watchpoints/index>
:hidden:
:maxdepth: 1

access_debugging_in_add-ons/index
breaking_on_exceptions/index
debug_eval_sources/index
disable_breakpoints/index
highlight_and_inspect_dom_nodes/index
ignoring_sources/index
open_the_debugger/index
pretty-print_a_minified_file/index
search/index
set_a_breakpoint/index
set_a_conditional_breakpoint/index
set_watch_expressions/index
step_through_code/index
use_a_source_map/index
use_watchpoints/index