Adding clarity to buffer toString docs.
Checklist
-
documentation is changed or added -
commit message follows commit guidelines
Affected core subsystem(s)
Update to the docs
Description of change
As discussed in #8971 (closed), the docs for this method could be improved. This is my attempt at clarification.