tests: improve documentation

Closes #711