add detailed description of how we generate public reports