Auto-generated commit

Author: stdlib-bot

.github/.keepalive

@@ -2,6 +2,41 @@
 
 > Package changelog.
 
+<section class="release" id="unreleased">
+
+## Unreleased (2026-04-19)
+
+<section class="commits">
+
+### Commits
+
+<details>
+
+-   [`5e89f8b`](https://github.com/stdlib-js/stdlib/commit/5e89f8b25d48b08a844cbb05f943de3c3121f0d0) - **docs:** improve doctests for ndarray instances in `ndaray/iter/stacks` [(#11539)](https://github.com/stdlib-js/stdlib/pull/11539) _(by Uday Kakade, Athan Reines)_
+
+</details>
+
+</section>
+
+<!-- /.commits -->
+
+<section class="contributors">
+
+### Contributors
+
+A total of 2 people contributed to this release. Thank you to the following contributors:
+
+-   Athan Reines
+-   Uday Kakade
+
+</section>
+
+<!-- /.contributors -->
+
+</section>
+
+<!-- /.release -->
+
 <section class="release" id="v0.1.1">
 
 ## 0.1.1 (2026-02-08)

CHANGELOG.md

@@ -79,24 +79,17 @@ Returns an iterator which iterates over each subarray in a stack of subarrays ac
 
 ```javascript
 var array = require( '@stdlib/ndarray-array' );
-var ndarray2array = require( '@stdlib/ndarray-to-array' );
 
 var x = array( [ [ [ 1, 2 ], [ 3, 4 ] ], [ [ 5, 6 ], [ 7, 8 ] ] ] );
 // returns <ndarray>
 
 var iter = nditerStacks( x, [ 1, 2 ] );
 
 var v = iter.next().value;
-// returns <ndarray>
-
-var arr = ndarray2array( v );
-// returns [ [ 1, 2 ], [ 3, 4 ] ]
+// returns <ndarray>[ [ 1, 2 ], [ 3, 4 ] ]
 
 v = iter.next().value;
-// returns <ndarray>
-
-arr = ndarray2array( v );
-// returns [ [ 5, 6 ], [ 7, 8 ] ]
+// returns <ndarray>[ [ 5, 6 ], [ 7, 8 ] ]
 
 // ...
 ```
@@ -109,7 +102,6 @@ By default, the iterator returns [`ndarray`][@stdlib/ndarray/ctor] views which a
 
 ```javascript
 var array = require( '@stdlib/ndarray-array' );
-var ndarray2array = require( '@stdlib/ndarray-to-array' );
 
 var x = array( [ [ [ 1, 2 ], [ 3, 4 ] ], [ [ 5, 6 ], [ 7, 8 ] ] ] );
 // returns <ndarray>
@@ -119,15 +111,10 @@ var iter = nditerStacks( x, [ 1, 2 ], {
 });
 
 var v = iter.next().value;
-// returns <ndarray>
-
-var arr = ndarray2array( v );
-// returns [ [ 1, 2 ], [ 3, 4 ] ]
+// returns <ndarray>[ [ 1, 2 ], [ 3, 4 ] ]
 
 v.set( 0, 0, 10 );
-
-arr = ndarray2array( v );
-// returns [ [ 10, 2 ], [ 3, 4 ] ]
+// v => <ndarray>[ [ 10, 2 ], [ 3, 4 ] ]
 ```
 
 The returned [iterator][mdn-iterator-protocol] protocol-compliant object has the following properties:

README.md

@@ -47,9 +47,8 @@
     --------
     > var x = {{alias:@stdlib/ndarray/array}}( [ [ [ 1, 2 ], [ 3, 4 ] ] ] );
     > var it = {{alias}}( x, [ 1, 2 ] );
-    > var v = it.next().value;
-    > {{alias:@stdlib/ndarray/to-array}}( v )
-    [ [ 1, 2 ], [ 3, 4 ] ]
+    > var v = it.next().value
+    <ndarray>[ [ 1, 2 ], [ 3, 4 ] ]
 
     See Also
     --------

dist/index.js.map

@@ -52,24 +52,17 @@ interface Options {
 *
 * @example
 * var array = require( '@stdlib/ndarray-array' );
-* var ndarray2array = require( '@stdlib/ndarray-to-array' );
 *
 * var x = array( [ [ [ 1, 2 ], [ 3, 4 ] ], [ [ 5, 6 ], [ 7, 8 ] ] ] );
 * // returns <ndarray>
 *
 * var iter = nditerStacks( x, [ 1, 2 ] );
 *
 * var v = iter.next().value;
-* // returns <ndarray>
-*
-* var arr = ndarray2array( v );
-* // returns [ [ 1, 2 ], [ 3, 4 ] ]
+* // returns <ndarray>[ [ 1, 2 ], [ 3, 4 ] ]
 *
 * v = iter.next().value;
-* // returns <ndarray>
-*
-* arr = ndarray2array( v );
-* // returns [ [ 5, 6 ], [ 7, 8 ] ]
+* // returns <ndarray>[ [ 5, 6 ], [ 7, 8 ] ]
 *
 * // ...
 */

docs/repl.txt

@@ -25,7 +25,6 @@
 *
 * @example
 * var array = require( '@stdlib/ndarray-array' );
-* var ndarray2array = require( '@stdlib/ndarray-to-array' );
 * var nditerStacks = require( '@stdlib/ndarray-iter-stacks' );
 *
 * var x = array( [ [ [ 1, 2 ], [ 3, 4 ] ], [ [ 5, 6 ], [ 7, 8 ] ] ] );
@@ -34,16 +33,10 @@
 * var iter = nditerStacks( x, [ 1, 2 ] );
 *
 * var v = iter.next().value;
-* // returns <ndarray>
-*
-* var arr = ndarray2array( v );
-* // returns [ [ 1, 2 ], [ 3, 4 ] ]
+* // returns <ndarray>[ [ 1, 2 ], [ 3, 4 ] ]
 *
 * v = iter.next().value;
-* // returns <ndarray>
-*
-* arr = ndarray2array( v );
-* // returns [ [ 5, 6 ], [ 7, 8 ] ]
+* // returns <ndarray>[ [ 5, 6 ], [ 7, 8 ] ]
 *
 * // ...
 */

docs/types/index.d.ts

@@ -63,24 +63,17 @@ var format = require( '@stdlib/string-format' );
 *
 * @example
 * var array = require( '@stdlib/ndarray-array' );
-* var ndarray2array = require( '@stdlib/ndarray-to-array' );
 *
 * var x = array( [ [ [ 1, 2 ], [ 3, 4 ] ], [ [ 5, 6 ], [ 7, 8 ] ] ] );
 * // returns <ndarray>
 *
 * var iter = nditerStacks( x, [ 1, 2 ] );
 *
 * var v = iter.next().value;
-* // returns <ndarray>
-*
-* var arr = ndarray2array( v );
-* // returns [ [ 1, 2 ], [ 3, 4 ] ]
+* // returns <ndarray>[ [ 1, 2 ], [ 3, 4 ] ]
 *
 * v = iter.next().value;
-* // returns <ndarray>
-*
-* arr = ndarray2array( v );
-* // returns [ [ 5, 6 ], [ 7, 8 ] ]
+* // returns <ndarray>[ [ 5, 6 ], [ 7, 8 ] ]
 *
 * // ...
 */