cleanup scaffolding.  add some nice documentation