Documentation and sample file changes

Primarily a revision of the user guide, and a PDF version generated from the markdown using [StackEdit](https://stackedit.io/#), for inclusion in the distribution ZIP.

I've also renamed the sample shell scripts by removing 'sample' from the front of the names, since it serves no purpose. The scripts themselves have been modified to reflect the recommendations in the user guide.