adjusted documentation
once again, refactoring....