Missing changelog
matej-marcisovsky opened this issue · 7 comments
What is the difference between 1.0.3 and 2.0.0? There is no changelog.
It seems like the mix function got inverted somewhere between pre-1.x and 2.0.
Thanks, but I would like to see change logs of future versions at least here in releases. @Qix- What do you think?
👎 on changelogs. I'll start putting things in the releases tab on Github. However, most PRs have migration steps.
You can use something like semantic-release +conventional-changelog to automatically generate a changelog for you and put it in the releases.
Also, reading migration steps in each individual PR is not exactly a dev-friendly or scalable approach.
Why 👎 on changelogs? Just makes it artificially harder for someone to figure out what changed between versions.
For anyone coming here for the same reason as me: the only thing changing between v2.0.1 and v3.0.0 was that the dark and light methods were renamed to isDark and isLight.
Sorry, changelogs are a dead breed of documentation. Semver isn't crafted to be a form of "big, exciting releases" - the major version was representative of a breaking change. Public API changed, a minor bump would have been incorrect.
Sorry, this opinion won't change.