Fixed validation error locators for foreman entities
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.
Merge pull request #1182 from Ichimonji10/duplicate-params

Remove mistake-prone code
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.
Merge pull request #1180 from sghai/fix-negative-test

Fixed validation error locators for foreman entities
Merge pull request #1181 from Ichimonji10/bz-1102732

Add API tests for api/v2/roles
Expand API test coverage

It would be good if every entity was mentioned within `test_multiple_paths.py`.
The tests in thie file should not actually be executed for every entity, but
when not, a reason should be noted.

Slightly expand test coverage by adding ActivationKey and User entities to each
test.
Merge pull request #1184 from Ichimonji10/api-tests

Expand API test coverage
Further expand API test coverage

Ensure that the following entities are listed as data for each test in
`test_multiple_paths.py`:

* ContentView
* Host
* Repository

Make tests which fail due to BZ 1122267 skip instead.

The only entity which is not listed as data for each test is
LifecycleEnvironment.
Merge pull request #1185 from Ichimonji10/more-api-tests

Further expand API test coverage
Added `smoke` to Make file.

Added new rule to Makefile to handle the new `smoke` tests.
Merge pull request #1186 from omaciel/make-smoke

Added `smoke` to Make file.
Default entities' names don't have underscores.

There have been some recent changes that updated the names for the
default organization and location:

* 'Default_Organization' => 'Default Organization'
* 'Default_Location' => 'Default Location'

Smoke tests have been updated accordingly.
Merge pull request #1187 from omaciel/fix-smoke

Default entities' names don't have underscores.
fixing 2 cli activation key tests
Blocked tests with Bz id
Merge pull request #1191 from sghai/block-template-test

Blocked template tests with Bz id
Merge pull request #1189 from alda519/cli_fix_actkey

fixing 2 cli activation key tests