Document the client side upgrade process 798

Fixes #798