finish up theory doc
add note to rolling upgrades doc