Rewrite README.rst and copy it to doc/source/index.rst to add a little
bit more content.
Generate documentation for APIs. fixture, safe_utils and test submodules
are not documented.
Fix indentation in obj_reset_changes() docstring.
Fix formatting of obj_make_list() docstring.
Co-Authored-By: Dan Smith <dansmith@redhat.com>
Change-Id: I8110919de072c5a5139e3797f256925c92656117
