updated docstrings and file headers