On Thu, 5 Mar 2026 00:14:09 GMT, Kevin Rushforth <[email protected]> wrote:
> > I'm biased, but I agree that the Headless Platform would fit in the > > "Important Changes" section. > > Sorry, I missed this when @erwin1 commented on it. > > The Headless Platform is an important feature, to be sure, along with the > Metal Graphics Pipeline (also in 26), the HeaderBar preview API (initially in > 25), the rich text area incubator (initially in 24), etc. However, those > aren't the sort of changes that go in the "Important Changes" section with a > release note. That section is for things that might affect application > compatibility or default behavior that would be visible to the application, > which is why it's limited to the three that have an associated note. > > The new features are listed right below those with a release note, but we > don't have an individual release note or description for any of them. Linking > to the CSR would be a good start, but maybe we should consider a section for > "New Features" with a short description for each? We'd want to discuss which > features (all of the ones in the "New Features" section? a subset of the most > important ones?) and how much to write about them. I'm not sure I'd want to > do it this late in the release cycle for JavaFX 26, though. > > Thoughts? In general, I'm in favor of as little interpretation as possible in the release notes. I consider those as purely technical information, that allow developers (or devrels/teachers/marketing folks) to at least get links to the changes (in JBS). The interpretation itself can be done in different ways by different people with different roles -- and I strongly encourage them to do so. Hence, I think it may even be better not having descriptions for the "New Features", as such descriptions are hard to be technology-neutral and can lead to long discussions. Those discussions and descriptions are great, but I don't think they are part of the purely technical release notes. To be clear: I am 100% in favor of extensive descriptions and explanations of everything that is added or modified in OpenJFX -- but I believe there are better formats to do this than in release notes that go in the repo. ------------- PR Comment: https://git.openjdk.org/jfx/pull/2090#issuecomment-4002933170
