docs: improve doctests for ndarray instances in ndaray/iter/stacks

PR-URL: #11539
Co-authored-by: Athan Reines <kgryte@gmail.com>
Reviewed-by: Athan Reines <kgryte@gmail.com> 
Ref: #9329

Author: udaykakade25

lib/node_modules/@stdlib/ndarray/iter/stacks/README.md

@@ -46,24 +46,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 ] ]
 
 // ...
 ```
@@ -76,7 +69,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>
@@ -86,15 +78,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:

lib/node_modules/@stdlib/ndarray/iter/stacks/docs/repl.txt

@@ -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
     --------

lib/node_modules/@stdlib/ndarray/iter/stacks/docs/types/index.d.ts

@@ -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 ] ]
 *
 * // ...
 */

lib/node_modules/@stdlib/ndarray/iter/stacks/lib/index.js

@@ -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 ] ]
 *
 * // ...
 */

lib/node_modules/@stdlib/ndarray/iter/stacks/lib/main.js

@@ -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 ] ]
 *
 * // ...
 */