MkDocs build is slow

[StevenMaude]

This doesn't matter too much for an actual build during deployment, but is inconvenient for local editing.

This is primarily due to the use of the multirepo plugin. It takes over 10 seconds on my computer, which is a little bit slow when you're editing and wanting quick feedback on appearance. It used to take something like 1-2 seconds.

It apparently wants to clone the project every time you edit files; upstream issue: jdoiro3/mkdocs-multirepo-plugin#129.

Other non-ideal workarounds for local editing:

• remove the ehrQL section entirely when not working on it
• edit the repository URL to point to a local clone

#1317 might help here.

[StevenMaude]

• remove the ehrQL section entirely when not working on it

Specifically, what you'll have to do in mkdocs.yml:

• comment out the !import line that actually uses the multirepo plugin
• comment out the ehrql/stylesheets/extra.css line under extra_css
• comment out the hooks/ehrql_css.py line under hooks

and avoid accidentally committing/pushing these changes.

Little bit irritating. But this cuts the rebuild time on edit back down from 10-15 seconds to 2 seconds for me, while editing the main documentation.