cleanups and some documentation for task 1