DOC: Make links and improve style throughout docstrings