upgrade: clarify some text