updated documentation at a few points
updated documentation at a few points