Fix typos in documentation and layout. Clarify documentation.


Change-Id: Ie59f4004b8ddc3cf52c761b7c526d1617388c2e3
Signed-off-by: Mike Kelly <m.f.kelly@arts.ac.uk>