On Thu, 27 Feb 2025 19:40:18 GMT, Kevin Rushforth <k...@openjdk.org> wrote:
>> `doc-files/notes/24/JDK-8340852.md` >> >> the only problem with this is that the feature may not make it into specific >> release so the docs need to be moved, which will break the reviews and the >> mailing list. >> >> May be we can organize drafts using dates >> `/doc-files/drafts/2025/0227/JDK-8340852` and organize the final versions by >> release `/doc-files/notes/24/JDK-8340852`? > >> `doc-files/notes/24/JDK-8340852.md` >> >> the only problem with this is that the feature may not make it into specific >> release so the docs need to be moved, which will break the reviews and the >> mailing list. > > By the time something gets into the mainline jfx repo, we know which release > it is targeted to. We already have to update the `@since` tags for any > in-progress reviews when the targeted release changes, and this is no > different. > >> May be we can organize drafts using dates >> `/doc-files/drafts/2025/0227/JDK-8340852` and organize the final versions by >> release `/doc-files/notes/24/JDK-8340852`? > > This will never happen for additional release notes. By definition we don't > even write them until they are integrated. > > For JEPs, maybe... _if_ we ever put Draft DEPs in our repo (I don't think we > should, but let's cross that bridge when we have the JEP discussion). Getting back to this release note question, I did the split in a separate [8350136-release-notes-24.dev](https://github.com/kevinrushforth/jfx/tree/8350136-release-notes-24.dev) branch. Here is the [updated release note for the ScrollPane behavior change](https://github.com/kevinrushforth/jfx/blob/8350136-release-notes-24.dev/doc-files/release-notes-24.md#scrollpane-consumes-navigation-keys-only-when-it-has-direct-focus). @hjohn @andy-goryachev-oracle please take a look. ------------- PR Review Comment: https://git.openjdk.org/jfx/pull/1712#discussion_r1974241857