On Wed, 3 Jun 2026 14:20:40 GMT, Dan Heidinga <[email protected]> wrote:
> > I'd find it helpful to have some general discussion of the of the Javadoc
> > idioms used to document the preview features.
>
> @jddarcy to confirm, are you asking about the use of preview javadoc comments
> like:
>
> ```
> <div class="preview-block">
> <div class="preview-comment">
> @PreviewFeature
> ```
>
> rather than using `{@previewNote ...}`?
>From all the prior preview core libraries features I've reviewed, I don't
>recall any of them using the idiom JEP 401 is using so I'm asking for an
>explanation of what is being done and why.
-------------
PR Comment: https://git.openjdk.org/jdk/pull/31123#issuecomment-4614443920
