tweaked doc after refactoring