Update docs to reduce inconsistent type compatibility in api/

Change-Id: Iaf97aeb514ddb2176491c3820fe891be8e989939