I guess my feedback is :
please don't change the API within a minor number revision, this should be reserved for bug fixes.
new or changed API should obvious, 2.1.0 or 2.X.0, so that i know to read the docs before upgrading.
Thanks for the upgrade docs, the actual API Docs should list the version that each feature is introduced in.