add detailed description of how we generate public reports
Merge branch 'master' into testwamp