full docstring added to task 1