basic readme, docs, small refactoring