Consistent doc style, consistent with pep guidelines and for future Sphinx support. Fixed any issues outlined by Pycharm editor that need to be further tested.