doc: Enable Sphinx features, improve readability

* Enable Sphinx extensions.
* Modify section markers to align with readthedocs-sphinx-search.
* Improve readability when rendered with Sphinx.

Signed-off-by: Vineeth Raveendran <vineeth.raveendran@arm.com>