Clean up comments and docstrings

None of the changes in this commit have a functional impact.
I should explain why I'm adding this sort of whitespace. To explain, if no whitespace is added, then the text is considered one long paragraph. This looks horrid. For a practical example of the impact of this, see [here](http://robottelo.readthedocs.org/en/latest/api/tests.foreman.api.html#module-tests.foreman.api.test_activationkey_v2).