Report spec

@jackparmer creating a PR to make adding commentary a bit easier!
still not 100% on this. for example how would a user add a latex caption?