Fix incorrect hyperlink
Make Sphinx happy and Pylint happier

Fix docstrings so Sphinx can correctly interpret them. Fix some Pylint
complaints, and add `pylint: disable` directives as appropriate. Reformat a few
things to simply look nicer.
Clean up docstring
Handle pylint for robottelo.api.apicrud

Was left some warnings to be handled in a future refactor
Handle pylint for robottelo.api.base
Handle many pylint issues for records package
Merge pull request #890 from omaciel/pylint-fixes

Pylint fixes
Remove unused function `is_bzbug`
Replace bzbug with skip_if_bz_bug_open

Decorator skip_if_bz_bug_open can be used just like bzbug. However, there are
several advantages to using the new decorator.

* The new decorator is better named.
* The new decorator does not trigger calls to a bugzilla server when it is
  evaluated. Instead, calls to a bugzilla server are delayed until the test
  suite is executed.
* The new decorator skips tests under slightly different conditions. Formerly,
  if an error occurred while fetching information about a Bugzilla bug, the
  test would be skipped. Now, the test is allowed to run.

Finally, function _get_bugzilla_bug has been created. It is reponsible for
fetching and caching bug objects.
Fix numerous broken function calls

Do not call `bzbug`. Instead, call `skip_if_bz_bug_open`.
Replace redmine with skip_if_rm_bug_open

Decorator skip_if_rm_bug_open can be used just like redmine. However, the same
advantages that apply to using skip_if_bz_bug_open apply to this new decorator
too.
Fix numerous broken function calls

Do not call `redminebug`. Instead, call `skip_if_rm_bug_open`.
Clean up import statements
Merge pull request #889 from Ichimonji10/skiptests3

Lazily choose whether to skip tests
Change method of generating API docs

Do not use `sphinx-apidoc` to generate API docs. Instead, use the "autodoc"
sphinx extension. [1] Update the makefiles and documentation files to reflect
this change.

[1] http://sphinx-doc.org/ext/autodoc.html
Merge pull request #891 from Ichimonji10/apidocs

Change method of generating API docs
Tweak global settings

Make the `server.hostname` field in `robottelo.properties.sample` blank by
default. This prevents accidental battering of any domain by Robottelo users.
Formerly, a user could fetch a copy of the codebase and unwittingly start
battering awesome.server.com; now, that cannot happen.

Make the .gitignore file ignore files in a more targeted manner.

* The `_build` folder will only exist in `/docs/_build/`. Therefore, the full
  path to the `_build` folder should be used so as to avoid accidentally
  ignoring other dirs with the same name.
* The `docs/tests.*` and `docs/tests.*` files were formerly generated by
  sphinx-apidoc. However, that tool is no longer being used.
Merge pull request #892 from Ichimonji10/settings2

Tweak global settings