a bit of documentation
add config option for raising connection errors