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

Reply via email to