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