doc: reporting: minor clarifications. closes #687