tests: improve documentation

Closes #711
produces*