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: Id3cf2b7124fd25a172f246f6c269d8fb921df8d6
Signed-off-by: Automerger Merge Worker <android-build-automerger-merge-worker@system.gserviceaccount.com>