adds more configuration documentation. fixes #9