doc: add documentation for buffer.byteOffset
Also document a common issue when casting a Buffer object to a TypedArray object. Fixes: #19301

Also document a common issue when casting a Buffer object to a TypedArray object. Fixes: #19301
[squash] fix gramma
nodejs · AndreasMadsen · AndreasMadsen · AndreasMadsen · Jul 9, 2018 · nodejs-github-bot
diff --git a/doc/api/buffer.md b/doc/api/buffer.md
@@ -992,6 +992,31 @@ console.log(buffer.buffer === arrayBuffer);
 // Prints: true
 ```

+### buf.byteOffset
+
+* {integer} The byteOffset on the underlying `ArrayBuffer` object based on
diff --git a/doc/api/buffer.md b/doc/api/buffer.md
+using `buf.buffer`, as the first bytes in this `ArrayBuffer` may be unrelated
+to the `buf` object itself.
+
+A common issue is when casting a `Buffer` object to an `TypedArray` object,
diff --git a/doc/api/buffer.md b/doc/api/buffer.md
+in this case one needs to specify the `byteOffset` correctly:
+
+```js
+// create a buffer smaller than `Buffer.poolSize`
diff --git a/doc/api/buffer.md b/doc/api/buffer.md
+// create a buffer smaller than `Buffer.poolSize`
+const nodeBuffer = new Buffer.from([0, 1, 2, 3, 4, 5, 6, 7, 8, 9]);
+
+// When casting the node.js Buffer to a Int8 TypedArray remember to use the