Documentation updates

[SJaffa]

• The documentation Section 2.2 talks about a 'training folder' that does not exist
• Describes input file but doesn't mention makefile or how to run the executable (i.e. command line arguments)
• Contents page could be hyperlinks to relevant section