32 ms·
Just wanted to leave a comment about the ChangeLog which is a list of commits. It would be nice if they sat down for a day (or two) to write down proper release
by omouse 10y ago
Just wanted to leave a comment about the ChangeLog which is a list of commits. It would be nice if they sat down for a day (or two) to write down proper release notes that made reference to various commits and outlined exactly what is changing, like if there are backwards compatibility issues or if there are very important bugs solved.
The changelog here looks like a git log :/ I mean, I can do better on my own projects (and have been trying to do so with node-oauth-libre) but for a major project it would be nicer if it had nice release notes.
- koheripbal 10y ago...even if they only did this for the top 20/50/100 changes, it would be well worth it.
- kosinus 10y agoI actually like these release notes? The commits are an extra, and messages are always clearly worded, in my humble opinion. I guess the commit list is the first thing that pops out when skimming, but it's less important than the notable changes. 'Notable changes' is more akin to the release notes I think you want. As for breaking changes, Node.js follows semver. A major version lists breaking changes more clearly.