Update app documentation

Tom Rushbyrequested to merge
UpdateAppCommentary into master

Updates to readme, add guide for how-to resources and annotation of code for documentation.

Merge request reports