DOC: some stylistic improvements to docstring rendering in documentation