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
Remove mistake-prone code

Consider how weird it is that these two calls are equivalent:

    response = client.get(
        'https://example.com/katello/api/v2/environments',
        auth=get_server_credentials(),
        verify=False,
        params={'organization_id': 5},
    )
    response = client.get(
        'https://example.com/katello/api/v2/organizations/5/environments',
        auth=get_server_credentials(),
        verify=False,
    )

The above demonstrates that the API lacks orthogonality, which is bad. However,
things then get ugly. Consider this code:

    response = client.get(
        'https://example.com/katello/api/v2/organizations/5/environments',
        auth=get_server_credentials(),
        verify=False,
        params={'organization_id': 6},
    )

What will happen? **We have undefined behaviour.** Rather than allowing
ourselves to make this mistake, it is best if:

* We do not provide arguments via a URL, when possible.
* We do provide arguments as JSON data, when possible.