docs: update documentation with QA suggestions and other collected improvements

Small improvements and clarifications on multiple sections of the documentation, mainly to include suggestions from QA.

Signed-off-by: Sergio Alves <sergio.dasilvalves@arm.com>