Who has the power to make a "Latest" docs link?

Ethan McCue ethan at mccue.dev
Sat Sep 17 04:06:58 UTC 2022


The problem here is pretty simple. If someone googles Javadocs for a class
or method, they will end up on a page pointing to a specific version.

https://docs.oracle.com/en/java/javase/18/docs/api/java.base/java/util/concurrent/atomic/AtomicReference.html

Now that releases are way more frequent, there isn't much time for any
particular version to gather SEO traffic.

As such, the links that show up in search results for any particular class
are often for Java 8.

https://docs.oracle.com/javase/8/docs/api/java/util/concurrent/atomic/AtomicReference.html

No matter what it will take quite a while for this to change, but part of
the solution the rust community adopted for crates was to make a "/latest"
link. There are more steps to this I'm sure and it's not a comprehensive
strategy, but it seems like a good first step.

https://github.com/rust-lang/docs.rs/issues/1438

So in this case

https://docs.oracle.com/en/java/javase/latest/docs/api/java.base/java/util/concurrent/atomic/AtomicReference.html
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://mail.openjdk.org/pipermail/discuss/attachments/20220917/ad87cd34/attachment.htm>


More information about the discuss mailing list