document reporting (e.g. sequence diagrams)

[steinfletcher]

Context: We are writing better docs using hugo to replace the examples on in the README. When complete we'll host here: https://apitest.dev.