improve docs around conn pool