minor doc changes based on RC5 migration experience