RFR: JDK-8263468: New page for "recent" new API

[Erik Joelsson]

On Wed, 26 May 2021 16:02:29 GMT, Hannes Wallnöfer <hannesw at openjdk.org> wrote:

> This adds a new kind of summary list for new API added in specific releases, and adds information to the deprecated API list about elements that were deprecated in the given releases.
> 
> The changes to the code are relatively minor thanks to the existing infrastructure for summary list pages, which was extended by adding the `getTableCaption` and `addTableTabs` methods to `SummaryListWriter.java` in order to generate tabbed tables. 
> 
> One important area that needs to be reviewed is the addition of resources in `standard.properties`. A relatively big share of discussion and effort went into shaping the UI messages.
> 
> The build system change adds options to generate API changes for all releases after JDK 11, with "New API since JDK 11" as page title for the new API page. I uploaded the generated documentation here:
> 
> http://cr.openjdk.java.net/~hannesw/8263468/api-pr.00/new-list.html
> http://cr.openjdk.java.net/~hannesw/8263468/api-pr.00/deprecated-list.html

make/Docs.gmk line 336:

> 334: 
> 335:   # Add summary pages for new/deprecated APIs in recent releases
> 336:   $1_OPTIONS += --since 12,13,14,15,16,17 --since-label "New API since JDK 11"

How do you expect this to change as the JDK version is bumped? If there is an expected pattern, then maybe we should try to generate the list instead, so we don't need to manually update twice a year.

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

PR: https://git.openjdk.java.net/jdk/pull/4209