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
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