Changes include:
 - multiple fixes on some .rst files to reflect newer RTD/sphinx syntax;
 - fix conf.py to allow build;
 - minor improvements in the document structure;
 - add warning banner message pointing to latest TC release documentation.

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