tests: improve documentation

Closes #711
D'ailleurs c'est pas un peu long comme synopsys?