deal with parse errors in driver module
rearrange: docs into subdir, clojure code into subdir
some more examples
clean up CLI
fix up README, with examples etc.
fix bug in metadata checking: wasn't calling the function