On Wed, 21 May 2025 17:58:30 GMT, Mark Reinhold <m...@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