doc: clarify docs around write_files