Merge "Document the expectations of two arguments." am: 0038349332 am: da9c6533d9

Original change: https://android-review.googlesource.com/c/platform/development/+/1861785

Change-Id: I8819bdb20a35b9499123f5ecb739da47d1235538