fs: document intention and caveats of Buffer API
Pull Request check-list
Please make sure to review and check all of these items:
-
Is the commit message formatted according to [CONTRIBUTING.md][0]?
Affected core subsystem(s)
fs
Description of change
This should prevent potential confusion of newcomers.