Add some API docs for common confusions

Bug: n/a
Test: doc only
Flag: EXEMPT doc only change
Change-Id: I08ea07e91cebc77dfd1bce15d051553e6e062578
3 files changed