add documentation for socket policies
clarified documentation for bad_connection error
add docs for namespaces and concurrency policies