Closed Bug 2084089 Opened 1 month ago Closed 13 days ago

Skip the mots path index when exporting the governance docs

Categories

(Developer Infrastructure :: Source Documentation, task)

task

Tracking

(firefox162 fixed)

RESOLVED FIXED
162 Branch
Tracking Status
firefox162 --- fixed

People

(Reporter: Sylvestre, Assigned: Sylvestre)

References

(Blocks 1 open bug)

Details

Attachments

(1 external file)

At the start of every docs build, export_mots in python/mozbuild/mozbuild/sphinx.py calls Directory.load(), which matches every module's include and exclude patterns against the whole source tree to build a path index. The governance page export only uses the module metadata, so the index is never read.

Skipping that call saves about 4 seconds on every build, including incremental ones: a clean ./mach doc -j 4 goes from 52.0 s to 47.3 s (3 runs each). The generated mots/index.html is identical.

The export only needs the module metadata. Directory.load() globs every
module's include and exclude patterns over the whole tree, which took about
4 seconds at the start of every docs build.

Assignee: nobody → sledru
Status: NEW → ASSIGNED
Pushed by sledru@mozilla.com: https://github.com/mozilla-firefox/firefox/commit/54d19002b902 https://hg.mozilla.org/integration/autoland/rev/dbbb7a0d9b8b Skip the mots path index when exporting the governance docs r=firefox-source-docs-reviewers,ahal
Status: ASSIGNED → RESOLVED
Closed: 13 days ago
Resolution: --- → FIXED
Target Milestone: --- → 162 Branch
You need to log in before you can comment on or make changes to this bug.

Attachment

General

Created:
Updated:
Size: