refactored documentation comments