adding docstrings and noting the required change of filelist collection