doc: improve Buffer documentation

Various improvements to the Buffer docs.

PR-URL: #32086
Reviewed-By: James M Snell <[email protected]>

Author: addaleax