doc: clarify docs around write_files

nice