Merge "Documentation updates as per the API council review and proof reading." into main am: d411e0aa8f am: 6e9c879a2a

Original change: https://android-review.googlesource.com/c/platform/hardware/interfaces/+/2835300

Change-Id: I0a4d7f7232bcb19efe85c888d6c5f97875549938
Signed-off-by: Automerger Merge Worker <android-build-automerger-merge-worker@system.gserviceaccount.com>