updated documentation and ensured it is consistent with Sphinx syntax