RFC 697: Update developer-facing docs

Created by: efritz

See RFC 697: Multiple version upgrades.

Update developer-facing docs on out-of-band migration assumptions.