docs: update examples

kgryte · kgryte · commit e35173c604ed · 2026-01-11T21:32:08.000-08:00
---
type: pre_commit_static_analysis_report
description: Results of running static analysis checks when committing changes.
report:
  - task: lint_filenames
    status: passed
  - task: lint_editorconfig
    status: passed
  - task: lint_markdown
    status: passed
  - task: lint_package_json
    status: na
  - task: lint_repl_help
    status: na
  - task: lint_javascript_src
    status: na
  - task: lint_javascript_cli
    status: na
  - task: lint_javascript_examples
    status: na
  - task: lint_javascript_tests
    status: na
  - task: lint_javascript_benchmarks
    status: na
  - task: lint_python
    status: na
  - task: lint_r
    status: na
  - task: lint_c_src
    status: na
  - task: lint_c_examples
    status: na
  - task: lint_c_benchmarks
    status: na
  - task: lint_c_tests_fixtures
    status: na
  - task: lint_shell
    status: na
  - task: lint_typescript_declarations
    status: passed
  - task: lint_typescript_tests
    status: na
  - task: lint_license_headers
    status: passed
---
diff --git a/lib/node_modules/@stdlib/random/README.md b/lib/node_modules/@stdlib/random/README.md
@@ -27,16 +27,16 @@ limitations under the License.
 ## Usage
 
 ```javascript
-var random = require( '@stdlib/random' );
+var ns = require( '@stdlib/random' );
 ```
 
-#### random
+#### ns
 
 Namespace containing random number functionality.
 
 ```javascript
-var rand = random;
-// returns {...}
+var arr = ns.normal( [ 3, 3 ], 2.0, 5.0 );
+// returns <ndarray>
 ```
 
 The namespace exports the following functions to sample and shuffle elements from an array:
@@ -82,15 +82,42 @@ The namespace contains the following sub-namespaces:
 
 ## Examples
 
-<!-- TODO: better examples -->
-
 <!-- eslint no-undef: "error" -->
 
 ```javascript
-var objectKeys = require( '@stdlib/utils/keys' );
+var logEach = require( '@stdlib/console/log-each' );
+var ndarray2array = require( '@stdlib/ndarray/to-array' );
 var ns = require( '@stdlib/random' );
 
-console.log( objectKeys( ns ) );
+// Create a function for generating arrays originating from the same state:
+var random = ns.normal.factory({
+    'state': ns.normal.state,
+    'copy': true
+});
+
+// Generate 3 one-dimensional arrays:
+var x1 = random( [ 5 ], 2.0, 5.0 );
+var x2 = random( [ 5 ], 2.0, 5.0 );
+var x3 = random( [ 5 ], 2.0, 5.0 );
+
+// Print the contents:
+logEach( '%f, %f, %f', ndarray2array( x1 ), ndarray2array( x2 ), ndarray2array( x3 ) );
+
+// Create another function for generating random arrays with the original state:
+random = ns.normal.factory({
+    'state': ns.normal.state,
+    'copy': true
+});
+
+// Generate a two-dimensional array which replicates the above pseudorandom number generation sequence:
+var x4 = random( [ 3, 5 ], 2.0, 5.0 );
+
+// Convert to a list of nested arrays:
+var arr = ndarray2array( x4 );
+
+// Print the contents:
+console.log( '' );
+logEach( '%f, %f, %f', arr[ 0 ], arr[ 1 ], arr[ 2 ] );
 ```
 
 </section>
