docs: Update upgrade notes,  add a new section about key pair management
and update existing docs.