Closes #48.

Also replace specific advice about API changes to point users
to read the release notes.