refactor definer
don't break if there is no config
add lots of docs
add more docs change findAll to do a loose right comparison