Fix paths on docs update

[joemull]

I built the docs with Sphinx to catch path errors on the docs-update branch, and then made minimal changes to fix those errors that it was showing me. This branch shows the comparison. If it looks good to you @S-Haime, we can merge it in to docs-update and proceed with that branch.

I'll also be sending you the built docs separately so that you can see how they look built.