tests: improve documentation

Closes #711
Idem ici, `Did something break ?`