tests: improve documentation

Closes #711
`that is the what of the what the what?`