Phrasing improvement
Updating readme
Incompleteness note
Fixed a few paths to be relative to facilitate development
Merge branch 'master' into gh-pages