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
Merge pull request #876 from Ichimonji10/pylint-fixes

Pylint fixes
Handle pylint for robottelo.api.apicrud

Was left some warnings to be handled in a future refactor