Drop dead code, update docs

Drop dead code from module `robottelo.factories`. Clearly document the remaining code as being for educational purposes.

Update docs. Ensure that private methods are included in the auto-generated documentation for module `robottelo.factory` and add more links (using the Sphinx `:meth:` directive).