updated documentation/comments