On Thu, 4 Dec 2025 21:54:17 GMT, Michael Strauß <[email protected]> wrote:
>>> maybe something like "This poorly named method is deprecated in favor of
>>> ..." or words to that extent?
>>
>> We wouldn't do this in the description, but possibly in the `@deprecated`
>> tag text (not sure).
>>
>>> or keep the original description?
>>
>> That's what we typically do, although I can see the value in what @mstr2
>> proposed. I'll take a look at the built docs and see how it looks.
>
> I've commited the suggested change without noticing your reply here. The
> description is now similar to:
>
> * This is a legacy method named inconsistently with method naming
> conventions,
> * use {@link #ofSpline(double, double, double, double)} instead.
>
> I can revert the change, or keep the existing description.
I'll take a closer look soon.
-------------
PR Review Comment: https://git.openjdk.org/jfx/pull/1996#discussion_r2590760291
