DOC: extend README with details of config

After my long struggles.
Merge pull request #3 from matthew-brett/extend-readme

DOC: extend README with details of config