add notes about last refactoring