On Tue, 1 Nov 2022 14:10:01 GMT, Daniel Fuchs <dfu...@openjdk.org> wrote:
>> src/java.base/share/classes/java/net/URL.java line 133:
>>
>>> 131: * specified. The optional fragment is not inherited.
>>> 132: *
>>> 133: * <h2><a id="constructor-deprecation"></a>Constructing instances of
>>> {@code URL}</h2>
>>
>> Would it be better to move the anchor to line 164 (the line where it says
>> that the URL constructors are deprecated?
>
> To be discussed: I actually wanted the deprecation link ( the link from
> `@deprecated` ) to lead here because I find that the whole section is
> relevant for developers who might want to decide whether to actually move
> away from using constructors, or be tempted to just use `@SuppressWarnings`.
Actually... Maybe I could move up the paragraph that says that URL constructors
are deprecated up here, just after the <h2> title? Would that be better?
-------------
PR: https://git.openjdk.org/jdk/pull/10874
