Fixes #397 - document writing tests

r? @karlcow