Release 1.0 upgrade guide

Patrick Ricerequested to merge
release-1-upgrade-guide into release-client-1.0

This MR contains information on the contents of the release along with what effort will be required to upgrade. It's meant to act as a slightly more comprehensive guide compared to the release notes. It also contains an update to the README.md noting the migration guide is available.

Merge request reports