3 ms·

Maybe this is a better link for you? https://jdk.java.net/21/release-notes https://jdk.java.net/21/release-notes Each feature links to a deeper dive into it.

shortrounddev2 3y ago
That's the link I'm talking about. A website which looks like it's from 2002, linking to each JEP. No syntax highlighting, and paragraphs of text to read before really showing a compare/contrast. It's the kind of thing that was written by programmers and not by writers Compare to C# releases: https://learn.microsoft.com/en-us/dotnet/csharp/whats-new/csharp-10 https://learn.microsoft.com/en-us/dotnet/csharp/whats-new/cs... Most links take you to a section of the same page, with syntax highlighting and optional light/dark mode on the site. For some features, it doesn't explain the rationale behind the change, it just shows the before/after, which is really all I care about: https://learn.microsoft.com/en-us/dotnet/csharp/whats-new/csharp-10#assignment-and-declaration-in-same-deconstruction https://learn.microsoft.com/en-us/dotnet/csharp/whats-new/cs...
- capableweb 3y ago
  Personally, all of what you wrote is a benefit when it comes to release notes. I don't want flashy GIFs, words written by non-programmers who don't actually understand what they are writing and I definitely don't want the marketing/web design part of a company to be involved in it. Simple, tell me what changes, where I can read more and that's it. It's the perfect release notes. But, as always, people like different things, as is apparent here :)
  - shortrounddev2 3y ago
    I just want important information boiled down to code examples and lists of features for me. I don't need to read an essay on the history of string interpolation
  - hbn 3y ago
    An example can summarize hundreds of words with less explanation cruft and wording confusion. Of all the math classes I've taken, the best teachers are the ones that just walk through examples. Not the ones explaining in abstract how to solve problems generally.
  - paulddraper 3y ago
    There were no flashy GIFs in the above links.

shortrounddev2 3y ago

That's the link I'm talking about. A website which looks like it's from 2002, linking to each JEP. No syntax highlighting, and paragraphs of text to read before really showing a compare/contrast. It's the kind of thing that was written by programmers and not by writers Compare to C# releases: https://learn.microsoft.com/en-us/dotnet/csharp/whats-new/csharp-10 https://learn.microsoft.com/en-us/dotnet/csharp/whats-new/cs... Most links take you to a section of the same page, with syntax highlighting and optional light/dark mode on the site. For some features, it doesn't explain the rationale behind the change, it just shows the before/after, which is really all I care about: https://learn.microsoft.com/en-us/dotnet/csharp/whats-new/csharp-10#assignment-and-declaration-in-same-deconstruction https://learn.microsoft.com/en-us/dotnet/csharp/whats-new/cs...

capableweb 3y ago
Personally, all of what you wrote is a benefit when it comes to release notes. I don't want flashy GIFs, words written by non-programmers who don't actually understand what they are writing and I definitely don't want the marketing/web design part of a company to be involved in it. Simple, tell me what changes, where I can read more and that's it. It's the perfect release notes. But, as always, people like different things, as is apparent here :)
- shortrounddev2 3y ago
  I just want important information boiled down to code examples and lists of features for me. I don't need to read an essay on the history of string interpolation
- hbn 3y ago
  An example can summarize hundreds of words with less explanation cruft and wording confusion. Of all the math classes I've taken, the best teachers are the ones that just walk through examples. Not the ones explaining in abstract how to solve problems generally.
- paulddraper 3y ago
  There were no flashy GIFs in the above links.