updated reporting and added example to markdown