Auto-generated commit

CHANGELOG.md

@@ -23,6 +23,7 @@
 
 <details>
 
+-   [`074cbef`](https://github.com/stdlib-js/stdlib/commit/074cbef3f9d616c37c2be856a949e257481ff2fc) - **docs:** add note concerning broadcasting of nested array elements _(by Athan Reines)_
 -   [`b079d65`](https://github.com/stdlib-js/stdlib/commit/b079d653226019925581555fdaf9aa927ec69c0e) - **feat:** add support for integer array indexing assignment _(by Athan Reines)_
 -   [`96e896a`](https://github.com/stdlib-js/stdlib/commit/96e896a39be08912b2e06dfb6b671ec13d042412) - **feat:** add support for boolean array indices _(by Athan Reines)_
 -   [`75d4f83`](https://github.com/stdlib-js/stdlib/commit/75d4f83cb85610d23a04dc21a03f8075f6d3665f) - **refactor:** update require and include paths _(by Athan Reines)_

README.md

@@ -405,6 +405,24 @@ y[ '10:20' ] = [ 8, 9, 10, 11 ];
 // throws <Error>
 ```
 
+In order to broadcast a nested array element as one would a scalar, one must wrap the element in a single-element array.
+
+```javascript
+var y = array2fancy( [ [ 1, 2 ], [ 3, 4 ] ] );
+
+// Assign individual array elements:
+y[ ':' ] = [ 5, 6 ];
+var v = y[ ':' ];
+// returns [ 5, 6 ]
+
+y = array2fancy( [ [ 1, 2 ], [ 3, 4 ] ] );
+
+// Broadcast a nested array:
+y[ ':' ] = [ [ 5, 6 ] ];
+v = y[ ':' ];
+// returns [ [ 5, 6 ], [ 5, 6 ] ]
+```
+
 ### Casting
 
 Fancy arrays support [(mostly) safe casts][@stdlib/array/mostly-safe-casts] (i.e., any cast which can be performed without overflow or loss of precision, with the exception of floating-point arrays which are also allowed to downcast from higher precision to lower precision).