DOC fix formatting of attributes etc. in docstrings
DOC move Attributes section to after Parameters and style likewise
Merge pull request #3489 from jnothman/attributes-doc

[MRG] DOC fix formatting of Attributes sections in documentation