Reconsider position of Attributes and Methods sections

[timhoffm]

#571 changed the section order to move Attributes and Methods right behind Parameters.

The order is now

numpydoc/numpydoc/docscrape.py

Lines 118 to 137 in 532cd7d

	sections = {
	"Signature": "",
	"Summary": [""],
	"Extended Summary": [],
	"Parameters": [],
	"Attributes": [],
	"Methods": [],
	"Returns": [],
	"Yields": [],
	"Receives": [],
	"Other Parameters": [],
	"Raises": [],
	"Warns": [],
	"Warnings": [],
	"See Also": [],
	"Notes": [],
	"References": "",
	"Examples": "",
	"index": {},
	}

For classes, we can get the order Paramters > Attributes > Methods > Other Parameters , which IMHO is not quite usable as the Other Parameters are very far away from Parameters.

We have to consider that the ordering should work both for classes and methods. As far as I understand, the motivation for Other Parameters is to deemphasise them and for methods to have the (typically short) sections Returns/Yields/Receives closer to the top.

I propose to move Attributes and Methods below Other Parameters, i.e.

Parameters
Returns
Yields
Receives
Other Parameters
Attributes
Methods

• There's no change for functions / methods as the don't use Attributes and Methods
• There's no change for classes without "Other Parameters" because they don't use Returns/Yields/Receives
• For classes with "Other Parameters" the sequence is "Parameters > Other Parameters > Attributes > Methods", which I think is better because the first two are input values to the construtor, while the other two are properties of the class.

One could argue that one should alternatively not use "Other Parameters" if one wants to render them next to each other anyway. But I claim it's still helpful to de-emphasize additional parameters through that extra section.

[mdhaber]

Would this be equivalent to moving Other Parameters right below Parameters?

[timhoffm]

Only when considering classes. For methods, that would put Other Parameters before Returns/Yields/Receives, which I assume is not wanted.

[mdhaber]

I see. Would you be willing to make a PR?

@lucascolley how does this proposal sound to you?

[lucascolley]

This sounds fine to me!