Update documentation of ConnectionPool

Updated documentation to address confusion of mine as indicated in Issue 388