misc refactoring
update documentation