Update README to add note about back-compat

Also add some very basic upgrading notes for the early adopters.
Merge branch 'more-docs' into develop

* more-docs:
  Update README to add note about back-compat