documentation how to handle ambiguous identities