DOC: some stylistic improvements to docstring rendering in documentation
Merge pull request #4775 from jorisvandenbossche/docstring-rendering

DOC: some stylistic improvements to docstring rendering in documentation