improve documentation and sample config