Report spec

@jackparmer creating a PR to make adding commentary a bit easier!
I think i've seen `to_json()` more commonly here. I could be wrong, but it might be more familiar to users?