simplify reporting commands and add some basic docs