Improve configuration documentation

Incorporated documentation suggestions from @jrz

Fixes #7