documentation updates, include upgrade notes for users upgrading from 2.2