finished solving reST warnings in docstrings