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