Add a dedicated documentation directory, move previous documentation to
it, add structure and add missing pieces of information.

Also fix some bugs.

Issue-Id: SCM-3993
Signed-off-by: Ambroise Vincent <ambroise.vincent@arm.com>
Change-Id: I70aa71081bc5e3174753f625ae00f4eddee9e3c5