Please review a change of how preview-related notes on permanent APIs are presented in the Preview API page. The section title changes to "Permanent APIs affected by Preview Features", and the section is rendered below the preview API summary tables rather than above.
In order to show the permanent API notes below the other tables I had to change the way extra content is added to API summary pages. The extra content hook methods we had before always displayed extra content before ordinary API summaries (such as terminally deprecated APIs on the Deprecated API page). The new code replaces these hook methods with methods that generate parts of the page and can be overridden in subclasses to add content before or after the default content. I did not structure summary tables into separate preview and permanent API hierarchies as suggested, as that would have made the UI much more complex both visually and functionally. ------------- Commit messages: - 8355933: Change section title for permanent APIs affected by preview features Changes: https://git.openjdk.org/jdk/pull/25224/files Webrev: https://webrevs.openjdk.org/?repo=jdk&pr=25224&range=00 Issue: https://bugs.openjdk.org/browse/JDK-8355933 Stats: 83 lines in 8 files changed: 24 ins; 19 del; 40 mod Patch: https://git.openjdk.org/jdk/pull/25224.diff Fetch: git fetch https://git.openjdk.org/jdk.git pull/25224/head:pull/25224 PR: https://git.openjdk.org/jdk/pull/25224