test for OK stream
move doctests to README.rst
fix typo in connection error handling