documenting response generators
buffer pool documentation