another round of clean up and documentation
fixup: config file