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

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

Change-Id: Ia6c3cfb254f07ea892733b2ff773d6037df2ca8e