updated refactoring documentation