I can't find the CHANGELOG
Offirmo opened this issue ยท comments
First thanks for this amazing and reliable lib!
Is your feature request related to a problem? Please describe.
yarn outdated
is telling me there is a new major versionof sinon. I'd like to check the changes. I couldn't find any changelog.
Describe the solution you'd like
There should be a changelog to evaluate the trade-offs of an upgrade.
It should be either:
- in Github releases
- in a standard CHANGELOG file
- on the website
Ideally there should be a CHANGELOG file and the website releases should point to it.
Describe alternatives you've considered
I checked:
- the release page: https://sinonjs.org/releases/v15/
- it doesn't contain any change log nor any link to a change log
- Github release notes https://github.com/sinonjs/sinon/releases
- they're outdated (from 2018)
- any standard CHANGELOG file at the root of the repo?
- there is none
Look at https://github.com/sinonjs/sinon/blob/main/CHANGES.md
I don't know why https://sinonjs.org/releases/ hasn't updated, but I'll take a look at it :)
@mroderick The changelog is online, but I don't think we have ever had a reference to it ๐
Added the link in a linked pr.
Amazing! Thanks a lot!
I missed the CHANGES.md
Any chance we could rename it to CHANGELOG.md
for discoverability? It seems to be some sort of standard https://common-changelog.org/#21-file-format
Thanks again!
I was thinking the same. It was actually called History.md
at one point, so it should not be a matter of religious importance ๐
We are inconsistent anyway. In the fake-timers repo it is called CHANGELOG, in referee
CHANGES, in nise
it's called History.md, etc
Even core contributor @mantoni's tool to generate such files, @studio/changes, generates CHANGES.md
, so we're somewhat consistent at least ๐
Studio Changes has a --file
option if a different name is preferred.