Improve documentation for buffering around functions taking a reader

Improve documentation for buffering around functions taking a reader: a task in repo2rlenv-pr-diff (Harbor dataset). Title: Improve documentation for buffering around functions taking a reader