Report spec

@jackparmer creating a PR to make adding commentary a bit easier!
*just formatting* add a `#` to the above two lines for readability in GH? :grinning: