Fix and improve documentation throughout the API.

Review Request #8774 — Created Feb. 21, 2017 and submitted — Latest diff uploaded

Information

Review Board
release-2.5.x
76093d0...

Reviewers

We had a number of places where our API documentation was incorrect,
incomplete, or just not consistent with other parts of the
documentation. This change fixes a handful of these cases throughout the
API codebase.

The simplest changes introduce double backticks for text that should be
literals. There's a large number of these, and they're going to make a
big difference with an upcoming change for the website.

There were older APIs that documented request arguments in the HTTP
method's docs instead of defining fields. These have been replaced with
@webapi_request_fields decorators. We also had a few of these decorators
that were including some incorrect information due to augmenting details
from other resources, so those have been fixed.

Some documentation has moved from class/method docstrings into field
docs. This will look good with the upcoming changes for the website.

We also just simply had some missing/incomplete documentation, which has
been added/rewritten.

Went through every single API page we had and verified the contents
appeared sane and consistent.

These changes are tested along with an upcoming change for API doc
generation and website styling.