refactored documentation