More additions to user docs.

This pull requests provides a more complete set of user and reference documentation. It also removes the old markdown file and changes some documentation related items in Config.groovy.

The first merge commit f7ffdd5 could likely be dropped.

After this, I believe with the prior pull requests which have been merged, could proceed to a new release.