Merge "Add some API docs for common confusions" into main am: ac3c566bad am: adbeb288b4

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

Change-Id: I500a9b4e5f9f44bcbc144c3633714ed07ccd8c81
Signed-off-by: Automerger Merge Worker <android-build-automerger-merge-worker@system.gserviceaccount.com>