MkDocs

Currently when you look at the Sphinx builds on RTD, it's super hard to understand what all the options do. We should switch from -m sphinx -T -E -b html -d _build/doctrees -D language=en to using the long-form options so users have more understanding of what is happening.

This change should happen in this file, and just add long-form arguments instead of the short one:
https://github.com/

You can have two API objects that use the same anchor reference. When both are rendered into the same Markdown file, the references are not unique, and one of the links will not work.

def a():
  """ Links to [a][0].

  [0]: https://a.org """

def b():
  """ Links to [b][0].

  [0]: https://b.org """

The MarkdownRenderer should find such duplicate references (here 0 an

It would be great if there was a function in the theme handler in which I could modify the HTML before it's converted to PDF, for example to add a title page.

(At the moment, I tried to add a title page by combining the output with a pre-made PDF for the title page using Ghostscript, but the problem is that Ghostscript ruins all the named destinations links, so internal links won't work. Would