resource_pool: doc improvements