Generate Sphinx docs/before Jekyll runs so we can use {% link %} tags in Jekyll pages to reference docs now
Also necessitates a stupid _config.yml trick to include Sphinx's _static directory, since Jekyll doesn't understand subdirectories in the include setting (jekyll/jekyll#1352)
Future project: convert existing documentation links in the Jekyll site to use link
Define a new type of auto-generated redirect in _redirects that redirects from an existing page to somewhere else (including forcing Netlify to ignore the existing page and redirect anyway)
Use the new redirect type to overwrite the outdated "Command-line arguments" page taken from the wiki in the Great Migration and point it at the automatically-updated Sphinx CLI docs instead
Bonus: Tell Git to ignore some more build-artifact-y stuff
Summary of changes:
docs/
before Jekyll runs so we can use{% link %}
tags in Jekyll pages to reference docs now_config.yml
trick to include Sphinx's_static
directory, since Jekyll doesn't understand subdirectories in theinclude
setting (jekyll/jekyll#1352)link
_redirects
that redirects from an existing page to somewhere else (including forcing Netlify to ignore the existing page and redirect anyway)