doc: add note about Buffer octets integer coercion

vsemozhetbyt · vsemozhetbyt · commit 0e803d1d8137 · 2019-04-03T00:51:10.000+03:00
PR-URL: nodejs#27030 Reviewed-By: Luigi Pinca <luigipinca@gmail.com> Reviewed-By: Ruben Bridgewater <ruben@bridgewater.de>
diff --git a/doc/api/buffer.md b/doc/api/buffer.md
@@ -12,7 +12,8 @@ streams in TCP streams, file system operations, and other contexts.
 With [`TypedArray`] now available, the `Buffer` class implements the
 [`Uint8Array`] API in a manner that is more optimized and suitable for Node.js.
 
-Instances of the `Buffer` class are similar to arrays of integers but
+Instances of the `Buffer` class are similar to arrays of integers from `0` to
+`255` (other integers are coerced to this range by `& 255` operation) but
 correspond to fixed-sized, raw memory allocations outside the V8 heap.
 The size of the `Buffer` is established when it is created and cannot be
 changed.
