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

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

Change-Id: If7d6c9e146578457f1d084defcbae3c3da9c4811