buffers default to having a capacity
added to doc strings
updated doc typos