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

[Jonathan Gibbons]

> 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.

Jonathan Gibbons has updated the pull request with a new target base due to a merge or a rebase. The incremental webrev excludes the unrelated changes brought in by the merge/rebase. The pull request contains two additional commits since the last revision:

 - Merge remote-tracking branch 'upstream/master' into 8313204.member-order
 - JDK-8313204: Inconsistent order of sections in generated class documentation

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

Changes:
  - all: https://git.openjdk.org/jdk/pull/15046/files
  - new: https://git.openjdk.org/jdk/pull/15046/files/0bf7c205..f9a96fec

Webrevs:
 - full: https://webrevs.openjdk.org/?repo=jdk&pr=15046&range=01
 - incr: https://webrevs.openjdk.org/?repo=jdk&pr=15046&range=00-01

  Stats: 2502 lines in 138 files changed: 1563 ins; 388 del; 551 mod
  Patch: https://git.openjdk.org/jdk/pull/15046.diff
  Fetch: git fetch https://git.openjdk.org/jdk.git pull/15046/head:pull/15046

PR: https://git.openjdk.org/jdk/pull/15046