Polishing the documentation. Correcting some technically incorrect bits and adding info about the variables.
Merging in more documentation fixes and additions. Merge branch 'proj1'