make using an existing connection work, and update docs with namespace info