update readme
update doc
add comments to configuration
improve exception message