Feedback on page "New APIs in Java 17"

[Thihup]

Hello, I would like to propose the following improvement on this page:

There are some 404 links:

[marchof]

Hi @Thihup, thanks for raising this issue. It is actually a known issue to me: The diffs are created by comparing the public signatures of the class files. But not all public APIs are visible in JavaDoc in rare cases.

In this case the package private class ClassSpecializer contains public inner classes -- which is technically possible. But no JavaDoc will be rendered for this.

I decided to show the pure diff, independent whether JavaDoc actually creates documentation for it.

[marchof]

What I can do about this specific case is to report this to OpenJDK to fix the visibility.