Class Attributes section in different place than documented

[QuLogic]

The class docstring section says to use the same sections as "above", meaning as in functions, and that "An Attributes section, located below the Parameters section, may be used to describe non-method attributes of the class". When this is rendered the Parameters and Attributes sections are separated by Notes, References, and Examples.

Now, the class docstring docs don't say that Attributes must immediately after Parameters, but ordering has always been important (#68), and having HTML docs be in a different order than in-code can make writing them confusing.

[FirefoxMetzger]

I've noticed this as well in the scipy docs

https://docs.scipy.org/doc/scipy/reference/generated/scipy.optimize.OptimizeResult.html#scipy.optimize.OptimizeResult

which implicitly depends on Notes being placed after Parameters, because it makes a relative reference in the notes ala "the above attributes". I've submitted a PR downstream (scipy/scipy#14693) for this specific instance, but it feels a bit like treating symptoms 😄

Could we move the Attributes section to immediately follow Parameters like @QuLogic suggested?