Skip to content

Speed up doc build by reworking links - #14167

Open
larsoner wants to merge 1 commit into
mne-tools:mainfrom
larsoner:rst
Open

Speed up doc build by reworking links#14167
larsoner wants to merge 1 commit into
mne-tools:mainfrom
larsoner:rst

Conversation

@larsoner

Copy link
Copy Markdown
Member

Until sphinx-doc/sphinx#14612 lands, this will speed up our doc build by not including names.inc in every doc. This PR:

  1. Removes links.inc from rst_prolog (better explicit than implicit: include in the few docs that need it)
  2. Removes dead links from links.inc
  3. Inlines single-use links from links.inc (we should include links there only if they're used multiple places)
  4. Moves some multi-use links from repeated defs to links.inc
  5. Adds a checker for the above (e.g., links in links.inc if and only if referenced twice, none dead, etc.)

Changes drafted with Claude Fable 5 and reviewed and iterated on by me.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant