please allow Markdown URL links in JEP 467 `@see`

Garret Wilson garret at globalmentor.com
Fri Nov 7 14:44:11 UTC 2025


On 11/7/2025 7:45 AM, Hannes Wallnoefer wrote:
>  …
> So basically we’d have to add a fourth form to support Markdown links.

Yes, please. Who wants things half-way done? Nobody wants to arbitrarily 
mix in different formats. And as I mentioned, it's just a nightmare to 
explain this to an LLM as it is to explain it to a junior developer. You 
think junior developers are going to remember all these gotcha exception 
rules?

>>
> A first step to evaluate these questions might be to file an 
> enhancement issue at https://bugs.openjdk.org/.

That was actually my very first stop, before I even filed the Stack 
Overflow issue if I remember correctly. But it looks like I have to have 
an OpenJDK login to even file a ticket. (It didn't used to be like that; 
I've filled Java bugs for eons.) How do I get an OpenJDK login?

Garret



More information about the javadoc-dev mailing list