Fix several build errors and warnings during doc building.

Review Request #9657 — Created Feb. 17, 2018 and submitted

Information

Review Board
release-3.0.x
6b37daf...

Reviewers

We had a few syntax errors, bad links, redundant references, bad
database values, and incorrect configuration settings for the
documentation that led to error output when building the Review Board
manual, and a handful of harmless but annoying warnings due to missing
image state when simulating data for the API documentation. This made it
hard at times to determine whether new changes to the documentation were
correct, particularly for new contributors to the documentation.

This change fixes the errors within the documentation and the
configuration options for the manual, and disables the logger that's
complaining about missing image files (which don't otherwise impact us).
It also updates us to Sphinx 1.7, which solves a couple of other
warnings with references and unveiled others.

There is one error remaining, which has to do with how Sphinx is
attempting to introspect the webapi resource registry in a way that's
causing an attribute error. This must be addressed in Djblets.

Documentation built without errors (except for the registry one) on
Sphinx 1.7.

Description From Last Updated

E265 block comment should start with '# '

reviewbotreviewbot
Checks run (1 failed, 1 succeeded)
flake8 failed.
JSHint passed.

flake8

david
  1. Ship It!
  2. 
      
chipx86
Review request changed
Status:
Completed
Change Summary:
Pushed to release-3.0.x (d634a43)