Files
Sylvestre Ledru 0eeac7d2fa Bug 2060036 - Fix the remaining code-fence, docstring and glossary doc warnings. r=taskgraph-reviewers,releng-reviewers,omc-reviewers,bhearsum,emcminn
Code fences whose language did not match their contents: the High
Contrast Mode CSS blocks use nesting, which Pygments' css lexer bails
out on, so fence them as scss; an asrouter JEXL example was fenced as
java; and the Fluent review doc used the {js} role for Fluent comment
markers.

RST docstrings rendered by autodoc: mozbuild's context.py and
gecko_taskgraph's backfill_action had lists and literal blocks not
preceded by a blank line, which also caused two knock-on 'Block quote
ends without a blank line' warnings.

Glossaries: the glossary directive treats non-indented lines as terms,
so the MyST ': definition' syntax made every definition look like a
term. Indent the definitions instead.

./mach doc goes from 661 to 636 warnings.

Differential Revision: https://phabricator.services.mozilla.com/D315869
2026-08-06 00:06:22 +00:00
..