Update pool documentation

@coolaj86 does this help? (re: #1084)