Merge "identity: Add clarifications to newly added API." am: ad3097312c am: e502cbe5db am: b8621b3097

Original change: https://android-review.googlesource.com/c/platform/frameworks/base/+/2007310

Change-Id: If3656d63600429ef32d881cfd52172bb78631575