externalized config, docs, and a bit of cleanup