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

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

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