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

Thu Jul 27 08:59:52 UTC 2023

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.

Looks good to me.

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

Marked as reviewed by hannesw (Reviewer).

PR Review: https://git.openjdk.org/jdk/pull/15046#pullrequestreview-1549344612