more documentation added to code