docs: add pool.end() documentation

closes #911
closes #912
Fix pool.end race conditions

fixes #915
Fix pool.getConnection race conditions
2.5.1