little doc block changes/refactorings