Fix several issues with documentation

* Fix a broken class reference.
* Add a missing module to the API docs.
* Fix gobs of badly formatted docstrings.
Merge pull request #1183 from Ichimonji10/sweep-the-floor

Fix several issues with documentation
Add API tests for api/v2/roles

* Add a full suite of tests targeting the "Role" entity.
* `EntityTestCase.test_get_status_code` targets bugzilla bug 1102732. The test
  passes, which indicates that the bug has been fixed.
* `api/v2/roles` suffers from bugzilla bug 1118015, and this is addressed in the
  updated test suite.
* The existing entity had an incorrect API path, and this has been fixed.
  (perhaps it has changed?)
* Creating tests for this URL has revealed another error, which is documented in
  bugzilla bug 1129785. Also, this PR contains tests targeting that specific
  bug.