more fully fleshed out the docs
more gracefully handles not being able to contact a host