fix: document proper claim update logic#2520

hperl merged 3 commits into

masterory/docs:masterfrom

hperl/document-traits-updatesory/docs:hperl/document-traits-updatesCopy head branch name to clipboard