updated documentation and ensured it is consistent with Sphinx syntax
added documentation on methods from tests