RFR: JDK-8313204: Inconsistent order of sections in generated class documentation

[Pavel Rappo]

On Wed, 26 Jul 2023 19:33:42 GMT, Jonathan Gibbons <jjg at openjdk.org> wrote:

> Please review a minor change to `ClassWriter` to make the order of sections consistent across member-kinds and between summary and detail sections. The change to `ClassWriter` is just to reorder the sections, and to add some explanatory comments.
> 
> One test detected the change and is therefore updated.
> Another test is updated to include a check for the section ordering.
> 
> Note: the changes to `ClassWriter` may soon be superseded by work on [JDK-8312201](https://bugs.openjdk.org/browse/JDK-8312201). The primary goal of this PR is to establish the preferred order and update the tests accordingly.

On JavaFX-style properties: is the suggested order something that JavaFX folk agree with? I'm not an expert, but it might be important for JavaFX documentation to display properties first on a page.

-------------

PR Comment: https://git.openjdk.org/jdk/pull/15046#issuecomment-1653425380