add some debug() calls
docs
add socket errors example
add error propagation example