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

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

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