added more documentation #2