RFR: 8347008: beancontext package spec does not clearly explain why the API is deprecated

[Alexey Ivanov]

On Tue, 21 Jan 2025 14:28:26 GMT, Alexander Zvegintsev <azvegint at openjdk.org> wrote:

> The beancontext package description or the deprecation text in the classes doesn't say anything about why the API is deprecated.
> A few more words have been added in this regard.

Overall, looks good, yet I've a question.

src/java.desktop/share/classes/java/beans/beancontext/package-info.java line 34:

> 32:  * a bean context.
> 33:  * <p>
> 34:  * These APIs are now both obsolete and express an "anti-pattern" of component

Why is “anti-pattern” in quotes? The word is used in its literal meaning, isn't it?

To emphasize, `<i>` or better `<em>` could be used.

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

Marked as reviewed by aivanov (Reviewer).

PR Review: https://git.openjdk.org/jdk/pull/23216#pullrequestreview-2565727924
PR Review Comment: https://git.openjdk.org/jdk/pull/23216#discussion_r1924385253