update readme
minor refactoring
readme formatting
add upgrade message