RFR: 8357000: Write overview documentation for start of release changes [v2]
Joe Darcy
darcy at openjdk.org
Fri May 23 22:38:51 UTC 2025
On Wed, 21 May 2025 17:58:30 GMT, Mark Reinhold <mr at openjdk.org> wrote:
> Writing this up is good, but I think it belongs in `doc` rather than `doc/ref`. In discussion, the latter morphed into `doc/internals`, and this isn’t about JDK internals. Also, this fits well alongside the `building.md` and `testing.md` files already in `doc`. (Which suggests that a name that’s a gerund might fit even better — `starting-next-release.md`? — for extra credit.)
>
> Consider framing the whole document as “how to prepare for the next release,” with explicit instructions on what to do. The present lists of concepts, and of files and changes, come across more as your personal notes rather than a list of instructions for someone to follow.
Okay; I'll relocate the file.
I think having both a conceptual overview as well as a list of current specific files / instructions is helpful in part of help make sure the file gets updated as needed in the future as any additional APIs that model something that get incremented in each release are added. Thanks.
-------------
PR Comment: https://git.openjdk.org/jdk/pull/25317#issuecomment-2905950343
More information about the build-dev
mailing list