tests: improve documentation

Closes #711
`that seem modified` non?