more docs scaffolding, clean up examples