doc: clarify docs around write_files
squash: fix spacing
Merge pull request #214 from bcwaldon/clarify-write-files

doc: clarify docs around write_files