update documentation to follow code refactoring