Not having a changelog document is a mistake

[hlovdal]

Documentation Is:

• Missing or needed?
• Confusing
• Not sure?

Please Explain in Detail...

I know this has been asked before, but the claim that https://github.com/chartjs/Chart.js/releases is sufficient is simply false.

Take for instance the 3.0.0 release. It contains ZERO information about breaking changes. None - zip - nada.

Do you honesestly think that is acceptable?

It contains links to 22 included pre-releases, are people supposed to be detectives and open each and every of them, and aggregate the breaking changes information themselves?

And if they attempt to do so, the first one (v3.0.0-alpha) contains no concrete information but instead links to a migration guide. The link is dead and gives a 404 error...

Seriously, do you really think this is good enough?

Your Proposal for Changes

There should exist a changelog document.

Example

No response

[LeeLenaleee]

All the breaking changes can be found in the migration guides.

We only do breaking changes with major version increases so between versions there are none.

And for all other releases the release notes genereated by github releases are fully covering.

Also 99% of the breaking changes are in the same GH release. This makes maintance burden a lot lower since we are with a small team

[kurkle]

Should create a redirect for the 404 migration guide link in those old release notes.

Maybe the links in release notes should also point to the exact version of docs (not sure how easy that would be to do)?

I,m not against a changelog, if it is automatically generated from pull requests.

[honzajavorek]

The ask is legit, but why is the tone of the issue so entitled? If you are writing sentences like „Do you honesestly think that is acceptable?“ or „Seriously, do you really think this is good enough?“, my question would be how much did you pay to the maintainers team for this amazing library, which otherwise saves you billion hours of coding time?

I'm not affiliated to the maintainers, just passing by.

[LeeLenaleee]

With the 4.3 release links in the release notes are pointing to the exact version and there is a redirect to the v3 migration guide