Please include Changelog

[shyamal890]

There is no way to track breaking changes as new versions are released.

If there is one in place, please consider including a link in ReadMe section.

[etimberg]

@shyamal890 what breaking changes are you running into?

The release notes details all of the changes that are made in each version

[panzarino]

You can check the previous history of releases on the releases page.

[etimberg]

Closing since @zachpanz88's answer is correct

[shyamal890]

@etimberg That is not what I am asking for, there is no way from the releases write-up to know which are the breaking changes we should be aware of before updating.

[simonbrunel]

@shyamal890 The releases section is exactly what you need to track when considering updating because it contains all the release notes. If there is a breaking change, it will be listed (and highlighted) for the concerned release. If there is nothing about a breaking change, then that's a regression.

I'm +1 to add a link to the releases from the README.md if that can help people to figure out where are the release notes. If that's not enough, then I'm not sure what you are suggesting?

[shyamal890]

I would suggest something like this: https://github.com/angular-ui/bootstrap/blob/master/CHANGELOG.md#133-2016-05-23

And yes, link in the README.md would be a great help

[simonbrunel]

How that's different from https://github.com/chartjs/Chart.js/releases? Both contains exactly the same information.

[shyamal890]

@simonbrunel There is no BREAKING CHANGES section in https://github.com/chartjs/Chart.js/releases

[simonbrunel]

That's a good news, right? That means Chart.js didn't introduce breaking changes for a while :) If a release has breaking changes, there will be a BREAKING CHANGES section or similar. For the README.md link, PR are welcome ;)

Edit: last breaking changes was in release 2.0.0-beta2 (Breaking API changes)