refactor: refactor comments for BufferPool class

- Change the comment for `BufferPool` from "BufferPool is Pool of *bytes.Buffer" to "BufferPool represents a pool of buffers"
- Change the comment for `Get()` from "Get a bytes.Buffer pointer" to "Get returns a buffer from the buffer pool. If the pool is empty, a new buffer is created and returned"
- Change the comment for `Put()` from "Put a bytes.Buffer pointer to BufferPool" to "Put adds a buffer back to the pool"

Signed-off-by: Bo-Yi Wu <appleboy.tw@gmail.com>

buffer_pool.go

@@ -5,12 +5,13 @@ import (
 	"sync"
 )
 
-// BufferPool is Pool of *bytes.Buffer
+// BufferPool represents a pool of buffers.
 type BufferPool struct {
 	pool sync.Pool
 }
 
-// Get a bytes.Buffer pointer
+// Get returns a buffer from the buffer pool.
+// If the pool is empty, a new buffer is created and returned.
 func (p *BufferPool) Get() *bytes.Buffer {
 	buf := p.pool.Get()
 	if buf == nil {
@@ -19,7 +20,7 @@ func (p *BufferPool) Get() *bytes.Buffer {
 	return buf.(*bytes.Buffer)
 }
 
-// Put a bytes.Buffer pointer to BufferPool
+// Put adds a buffer back to the pool.
 func (p *BufferPool) Put(buf *bytes.Buffer) {
 	p.pool.Put(buf)
 }