Merge "Update API documentation per api-council feedback." into rvc-dev am: e4e42d376a

Change-Id: I1efc7df99719fcc06d0a447ae5ba42ec645b7588