Clarify documentation for UserUpdated [skip ci]
Created by: uwx
Summary
This has caused many a headache in the past, so I suppose it's about time it got properly documented.
Details
I changed the documentation.
Changes proposed
- The documentation.
Notes
You need to cherry pick when closing the PR so it goes into the repo with the right title and doesn't trigger an unnecessary CI build. Although, I suppose you might want the docs to get updated.