Re: RFR: 8357000: Write overview documentation for start of release changes [v4]

2025-06-03 Thread Magnus Ihse Bursie
On Tue, 3 Jun 2025 04:43:59 GMT, Joe Darcy wrote: >> First attempt to populate "supplementary docs" with a discussion of the >> start of release changes. For reference on the idea of supplementary docs, >> see the thread >> >> "Where to put supplementary docs?" >> https://mail.openjdk.org/pipe

Re: RFR: 8357000: Write overview documentation for start of release changes [v4]

2025-06-03 Thread Iris Clark
On Tue, 3 Jun 2025 04:43:59 GMT, Joe Darcy wrote: >> First attempt to populate "supplementary docs" with a discussion of the >> start of release changes. For reference on the idea of supplementary docs, >> see the thread >> >> "Where to put supplementary docs?" >> https://mail.openjdk.org/pipe

Re: RFR: 8357000: Write overview documentation for start of release changes [v4]

2025-06-03 Thread Erik Joelsson
On Tue, 3 Jun 2025 04:43:59 GMT, Joe Darcy wrote: >> First attempt to populate "supplementary docs" with a discussion of the >> start of release changes. For reference on the idea of supplementary docs, >> see the thread >> >> "Where to put supplementary docs?" >> https://mail.openjdk.org/pipe

Re: RFR: 8357000: Write overview documentation for start of release changes [v4]

2025-06-02 Thread Joe Darcy
> First attempt to populate "supplementary docs" with a discussion of the start > of release changes. For reference on the idea of supplementary docs, see the > thread > > "Where to put supplementary docs?" > https://mail.openjdk.org/pipermail/jdk-dev/2025-April/009975.html Joe Darcy has update

Re: RFR: 8357000: Write overview documentation for start of release changes [v3]

2025-06-02 Thread Joe Darcy
> First attempt to populate "supplementary docs" with a discussion of the start > of release changes. For reference on the idea of supplementary docs, see the > thread > > "Where to put supplementary docs?" > https://mail.openjdk.org/pipermail/jdk-dev/2025-April/009975.html Joe Darcy has update

Re: RFR: 8357000: Write overview documentation for start of release changes [v2]

2025-05-23 Thread Joe Darcy
On Wed, 21 May 2025 17:58:30 GMT, Mark Reinhold 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 `testi

Re: RFR: 8357000: Write overview documentation for start of release changes [v2]

2025-05-23 Thread Joe Darcy
On Wed, 21 May 2025 21:14:12 GMT, Iris Clark wrote: > Some of these changes require a CSR. Should that be mentioned somewhere? I think "and all the usual review processes need to be followed" is implicit. My main intention is to both summarize the concept of what is in the start-of-release cha

Re: RFR: 8357000: Write overview documentation for start of release changes [v2]

2025-05-23 Thread Magnus Ihse Bursie
On Wed, 21 May 2025 17:58:30 GMT, Mark Reinhold wrote: > Writing this up is good, but I think it belongs in `doc` rather than > `doc/ref`. I agree. It does not feel substantially different from the other "process" documents we already have in `doc`. (That would also take care of generation of

Re: RFR: 8357000: Write overview documentation for start of release changes [v2]

2025-05-21 Thread Iris Clark
On Tue, 20 May 2025 17:14:38 GMT, Joe Darcy wrote: >> First attempt to populate "supplementary docs" with a discussion of the >> start of release changes. For reference on the idea of supplementary docs, >> see the thread >> >> "Where to put supplementary docs?" >> https://mail.openjdk.org/pip

Re: RFR: 8357000: Write overview documentation for start of release changes [v2]

2025-05-21 Thread Mark Reinhold
On Tue, 20 May 2025 17:14:38 GMT, Joe Darcy wrote: >> First attempt to populate "supplementary docs" with a discussion of the >> start of release changes. For reference on the idea of supplementary docs, >> see the thread >> >> "Where to put supplementary docs?" >> https://mail.openjdk.org/pip

Re: RFR: 8357000: Write overview documentation for start of release changes [v2]

2025-05-21 Thread Joe Darcy
On Wed, 21 May 2025 16:50:42 GMT, Erik Joelsson wrote: > > @erikj79 , do you know the build target that would generate the HTML from > > the new Mardown file? Thanks. > > ``` > make update-build-docs > ``` > > I'm not sure if it will search recursively through subdirectories or not. It did no

Re: RFR: 8357000: Write overview documentation for start of release changes [v2]

2025-05-21 Thread Erik Joelsson
On Tue, 20 May 2025 20:06:28 GMT, Erik Joelsson wrote: >> Joe Darcy has updated the pull request incrementally with one additional >> commit since the last revision: >> >> Respond to review feedback. > > Marked as reviewed by erikj (Reviewer). > @erikj79 , do you know the build target that w

Re: RFR: 8357000: Write overview documentation for start of release changes [v2]

2025-05-21 Thread Chen Liang
On Tue, 20 May 2025 17:14:38 GMT, Joe Darcy wrote: >> First attempt to populate "supplementary docs" with a discussion of the >> start of release changes. For reference on the idea of supplementary docs, >> see the thread >> >> "Where to put supplementary docs?" >> https://mail.openjdk.org/pip

Re: RFR: 8357000: Write overview documentation for start of release changes [v2]

2025-05-21 Thread Joe Darcy
On Tue, 20 May 2025 20:06:28 GMT, Erik Joelsson wrote: >> Joe Darcy has updated the pull request incrementally with one additional >> commit since the last revision: >> >> Respond to review feedback. > > Marked as reviewed by erikj (Reviewer). @erikj79 , do you know the build target that wou

Re: RFR: 8357000: Write overview documentation for start of release changes [v2]

2025-05-20 Thread Luca Kellermann
On Tue, 20 May 2025 17:14:38 GMT, Joe Darcy wrote: >> First attempt to populate "supplementary docs" with a discussion of the >> start of release changes. For reference on the idea of supplementary docs, >> see the thread >> >> "Where to put supplementary docs?" >> https://mail.openjdk.org/pip

Re: RFR: 8357000: Write overview documentation for start of release changes [v2]

2025-05-20 Thread David Holmes
On Tue, 20 May 2025 17:14:38 GMT, Joe Darcy wrote: >> First attempt to populate "supplementary docs" with a discussion of the >> start of release changes. For reference on the idea of supplementary docs, >> see the thread >> >> "Where to put supplementary docs?" >> https://mail.openjdk.org/pip

Re: RFR: 8357000: Write overview documentation for start of release changes [v2]

2025-05-20 Thread Erik Joelsson
On Tue, 20 May 2025 17:14:38 GMT, Joe Darcy wrote: >> First attempt to populate "supplementary docs" with a discussion of the >> start of release changes. For reference on the idea of supplementary docs, >> see the thread >> >> "Where to put supplementary docs?" >> https://mail.openjdk.org/pip

Re: RFR: 8357000: Write overview documentation for start of release changes [v2]

2025-05-20 Thread Joe Darcy
> First attempt to populate "supplementary docs" with a discussion of the start > of release changes. For reference on the idea of supplementary docs, see the > thread > > "Where to put supplementary docs?" > https://mail.openjdk.org/pipermail/jdk-dev/2025-April/009975.html Joe Darcy has update

Re: RFR: 8357000: Write overview documentation for start of release changes

2025-05-20 Thread David Holmes
On Tue, 20 May 2025 04:30:57 GMT, Joe Darcy wrote: > First attempt to populate "supplementary docs" with a discussion of the start > of release changes. For reference on the idea of supplementary docs, see the > thread > > "Where to put supplementary docs?" > https://mail.openjdk.org/pipermail

Re: RFR: 8357000: Write overview documentation for start of release changes

2025-05-20 Thread David Holmes
On Tue, 20 May 2025 10:25:11 GMT, David Holmes wrote: > Do you want to include manpage updates here? To answer myself "no". To clarify for others there are quite a lot of things that have to happen at the "start" of a release, but the ones documented here are the ones necessary to happen at th

Re: RFR: 8357000: Write overview documentation for start of release changes

2025-05-19 Thread Joe Darcy
On Tue, 20 May 2025 04:30:57 GMT, Joe Darcy wrote: > First attempt to populate "supplementary docs" with a discussion of the start > of release changes. For reference on the idea of supplementary docs, see the > thread > > "Where to put supplementary docs?" > https://mail.openjdk.org/pipermai