Hacker News Reader

Comment by capableweb | Hacker News Reader

Maybe this is a better link for you? https://jdk.java.net/21/release-notes

Each feature links to a deeper dive into it.

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/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/cs...

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 :)

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

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.

There were no flashy GIFs in the above links.

Reply on news.ycombinator.com