updated documentation comments