638 identity upgrade docu

[dominic22]

Just some minor comments, thanks for the important update! :)

Thanks, I've added your suggestions. 👍