new public files generation
more more verbose README
Merge branch 'master' into gh-pages