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

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

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