add developer doc
simplify shared data
doc cleanups
clean up command line args a bit