We fixed some issues to allow people use the upgrade command properly and we expanded the documentation to allow contract surgeries (upgrading a contract and downgrading it in the same transaction, in order to make something that was not allowed in the meantime).