In preparation to add functional tests for v3 auth, this change proposes to detail the method docs, because the tests need to be based on them. Change-Id: Idc60cb077d7e403a47cf9d6ad72f9d1a215c3f3b Partial-Bug: #1330769