DOC: Improve documentation and correct numpydoc errors