improved docs on sample config, and tests