Where to put supplementary docs?

Andrew Haley aph-open at littlepinkcloud.com
Wed May 21 08:20:49 UTC 2025


On 4/24/25 16:26, Robbin Ehn wrote:
> One major challenge with the other places (CR, JBS, PR, wiki), is that
> they don't handle versioning. (naturally)
> This means the code can't safely refer to, e.g., a wiki page, as that
> page may describe a newer version.
> If a developer is working in JDK 11 or in the Loom project, they need
> the relevant documentation for that specific fork/branch.

Exactly this. Also, as soon as a document is no longer relevant, it can 
be removed from the JDK source tree.

-- 
Andrew Haley  (he/him)
Java Platform Lead Engineer
Red Hat UK Ltd. <https://www.redhat.com>
https://keybase.io/andrewhaley
EAC8 43EB D3EF DB98 CC77 2FAD A5CD 6035 332F A671


More information about the jdk-dev mailing list