Document the client side upgrade process 798

Fixes #798 
The implication is that we're trashing other people's packages, which is not great....