tests: improve documentation

Closes #711
arsefile?