improved documentation comments