fix: apply suggestions from code review

---
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: passed
  - task: lint_javascript_src
    status: passed
  - task: lint_javascript_cli
    status: na
  - task: lint_javascript_examples
    status: na
  - task: lint_javascript_tests
    status: na
  - task: lint_javascript_benchmarks
    status: passed
  - task: lint_python
    status: na
  - task: lint_r
    status: na
  - task: lint_c_src
    status: missing_dependencies
  - task: lint_c_examples
    status: missing_dependencies
  - task: lint_c_benchmarks
    status: missing_dependencies
  - task: lint_c_tests_fixtures
    status: na
  - task: lint_shell
    status: na
  - task: lint_typescript_declarations
    status: passed
  - task: lint_typescript_tests
    status: passed
  - task: lint_license_headers
    status: passed
---

Author: headlessNode

lib/node_modules/@stdlib/blas/ext/base/ddiff/README.md

@@ -57,10 +57,10 @@ The function has the following parameters:
 -   **k**: number of times to recursively compute differences.
 -   **x**: input [`Float64Array`][@stdlib/array/float64].
 -   **strideX**: stride length for `x`.
--   **N1**: number of elements to `prepend`.
+-   **N1**: number of indexed elements to `prepend`.
 -   **prepend**: a [`Float64Array`][@stdlib/array/float64] containing values to prepend prior to computing differences.
 -   **strideP**: stride length for `prepend`.
--   **N2**: number of elements to `append`.
+-   **N2**: number of indexed elements to `append`.
 -   **append**: a [`Float64Array`][@stdlib/array/float64] containing values to append prior to computing differences.
 -   **strideA**: stride length for `append`.
 -   **out**: output [`Float64Array`][@stdlib/array/float64]. Must have `N + N1 + N2 - k` elements.
@@ -136,7 +136,7 @@ The function has the following additional parameters:
 -   **offsetOut**: starting index for `out`.
 -   **offsetW**: starting index for `workspace`.
 
-While [`typed array`][mdn-typed-array] views mandate a view offset based on the underlying buffer, the offset parameter supports indexing semantics based on a starting index. For example, to access only the last three elements:
+While [`typed array`][mdn-typed-array] views mandate a view offset based on the underlying buffer, the offset parameters support indexing semantics based on starting indices. For example, to access only the last three elements:
 
 ```javascript
 var Float64Array = require( '@stdlib/array/float64' );
@@ -232,7 +232,7 @@ console.log( 'Output: ', out );
 
 <!-- lint disable maximum-heading-length -->
 
-#### stdlib_strided_ddiff( N, k, \*X, strideX, N1, \*Prepend, strideP, N2, \*Append, strideA, \*Out, strideOut, \*Workspace, strideW )
+#### stdlib_strided_ddiff( N, k, \*X, strideX, N1, \*prepend, strideP, N2, \*append, strideA, \*out, strideOut, \*workspace, strideW )
 
 Calculates the k-th discrete forward differences of a double-precision floating-point strided array.
 
@@ -252,24 +252,24 @@ The function accepts the following arguments:
 -   **k**: `[in] CBLAS_INT` number of times to recursively compute differences.
 -   **X**: `[in] double*` input array.
 -   **strideX**: `[in] CBLAS_INT` stride length for `X`.
--   **N1**: `[in] CBLAS_INT` number of elements in `Prepend`.
--   **Prepend**: `[in] double*` array containing values to prepend prior to computing differences.
--   **strideP**: `[in] CBLAS_INT` stride length for `Prepend`.
--   **N2**: `[in] CBLAS_INT` number of elements in `Append`.
--   **Append**: `[in] double*` array containing values to append prior to computing differences.
--   **strideA**: `[in] CBLAS_INT` stride length for `Append`.
--   **Out**: `[inout] double*` output array. Must have `N + N1 + N2 - k` elements.
--   **strideOut**: `[in] CBLAS_INT` stride length for `Out`.
--   **Workspace**: `[inout] double*` workspace array. Must have `N + N1 + N2 - 1` elements.
--   **strideW**: `[in] CBLAS_INT` stride length for `Workspace`.
+-   **N1**: `[in] CBLAS_INT` number of indexed elements for `prepend`.
+-   **prepend**: `[in] double*` array containing values to prepend prior to computing differences.
+-   **strideP**: `[in] CBLAS_INT` stride length for `prepend`.
+-   **N2**: `[in] CBLAS_INT` number of indexed elements for `append`.
+-   **append**: `[in] double*` array containing values to append prior to computing differences.
+-   **strideA**: `[in] CBLAS_INT` stride length for `append`.
+-   **out**: `[inout] double*` output array. Must have `N + N1 + N2 - k` elements.
+-   **strideOut**: `[in] CBLAS_INT` stride length for `out`.
+-   **workspace**: `[inout] double*` workspace array. Must have `N + N1 + N2 - 1` elements.
+-   **strideW**: `[in] CBLAS_INT` stride length for `workspace`.
 
 ```c
-void stdlib_strided_ddiff( const CBLAS_INT N, const CBLAS_INT k, const double *X, const CBLAS_INT strideX, const CBLAS_INT N1, const double *Prepend, const CBLAS_INT strideP, const CBLAS_INT N2, const double *Append, const CBLAS_INT strideA, double *Out, const CBLAS_INT strideOut, double *Workspace, const CBLAS_INT strideW );
+void stdlib_strided_ddiff( const CBLAS_INT N, const CBLAS_INT k, const double *X, const CBLAS_INT strideX, const CBLAS_INT N1, const double *prepend, const CBLAS_INT strideP, const CBLAS_INT N2, const double *append, const CBLAS_INT strideA, double *out, const CBLAS_INT strideOut, double *workspace, const CBLAS_INT strideW );
 ```
 
 <!-- lint disable maximum-heading-length -->
 
-#### stdlib_strided_ddiff_ndarray( N, k, \*X, strideX, offsetX, N1, \*Prepend, strideP, offsetP, N2, \*Append, strideA, offsetA, \*Out, strideOut, offsetOut, \*W, strideW, offsetW )
+#### stdlib_strided_ddiff_ndarray( N, k, \*X, strideX, offsetX, N1, \*prepend, strideP, offsetP, N2, \*append, strideA, offsetA, \*out, strideOut, offsetOut, \*workspace, strideW, offsetW )
 
 Calculates the k-th discrete forward differences of a double-precision floating-point strided array using alternative indexing semantics.
 
@@ -290,23 +290,23 @@ The function accepts the following arguments:
 -   **X**: `[in] double*` input array.
 -   **strideX**: `[in] CBLAS_INT` stride length for `X`.
 -   **offsetX**: `[in] CBLAS_INT` starting index for `X`.
--   **N1**: `[in] CBLAS_INT` number of elements in `Prepend`.
--   **Prepend**: `[in] double*` array containing values to prepend prior to computing differences.
--   **strideP**: `[in] CBLAS_INT` stride length for `Prepend`.
--   **offsetP**: `[in] CBLAS_INT` starting index for `Prepend`.
--   **N2**: `[in] CBLAS_INT` number of elements in `Append`.
--   **Append**: `[in] double*` array containing values to append prior to computing differences.
--   **strideA**: `[in] CBLAS_INT` stride length for `Append`.
--   **offsetA**: `[in] CBLAS_INT` starting index for `Append`.
--   **Out**: `[inout] double*` output array. Must have `N + N1 + N2 - k` elements.
--   **strideOut**: `[in] CBLAS_INT` stride length for `Out`.
--   **offsetOut**: `[in] CBLAS_INT` starting index for `Out`.
--   **Workspace**: `[inout] double*` workspace array. Must have `N + N1 + N2 - 1` elements.
--   **strideW**: `[in] CBLAS_INT` stride length for `Workspace`.
--   **offsetW**: `[in] CBLAS_INT` starting index for `Workspace`.
+-   **N1**: `[in] CBLAS_INT` number of indexed elements for `prepend`.
+-   **prepend**: `[in] double*` array containing values to prepend prior to computing differences.
+-   **strideP**: `[in] CBLAS_INT` stride length for `prepend`.
+-   **offsetP**: `[in] CBLAS_INT` starting index for `prepend`.
+-   **N2**: `[in] CBLAS_INT` number of indexed elements for `append`.
+-   **append**: `[in] double*` array containing values to append prior to computing differences.
+-   **strideA**: `[in] CBLAS_INT` stride length for `append`.
+-   **offsetA**: `[in] CBLAS_INT` starting index for `append`.
+-   **out**: `[inout] double*` output array. Must have `N + N1 + N2 - k` elements.
+-   **strideOut**: `[in] CBLAS_INT` stride length for `out`.
+-   **offsetOut**: `[in] CBLAS_INT` starting index for `out`.
+-   **workspace**: `[inout] double*` workspace array. Must have `N + N1 + N2 - 1` elements.
+-   **strideW**: `[in] CBLAS_INT` stride length for `workspace`.
+-   **offsetW**: `[in] CBLAS_INT` starting index for `workspace`.
 
 ```c
-void stdlib_strided_ddiff_ndarray( const CBLAS_INT N, const CBLAS_INT k, const double *X, const CBLAS_INT strideX, const CBLAS_INT offsetX, const CBLAS_INT N1, const double *Prepend, const CBLAS_INT strideP, const CBLAS_INT offsetP, const CBLAS_INT N2, const double *Append, const CBLAS_INT strideA, const CBLAS_INT offsetA, double *Out, const CBLAS_INT strideOut, const CBLAS_INT offsetOut, double *Workspace, const CBLAS_INT strideW, const CBLAS_INT offsetW );
+void stdlib_strided_ddiff_ndarray( const CBLAS_INT N, const CBLAS_INT k, const double *X, const CBLAS_INT strideX, const CBLAS_INT offsetX, const CBLAS_INT N1, const double *prepend, const CBLAS_INT strideP, const CBLAS_INT offsetP, const CBLAS_INT N2, const double *append, const CBLAS_INT strideA, const CBLAS_INT offsetA, double *out, const CBLAS_INT strideOut, const CBLAS_INT offsetOut, double *workspace, const CBLAS_INT strideW, const CBLAS_INT offsetW );
 ```
 
 </section>
@@ -335,10 +335,10 @@ int main( void ) {
     // Create a strided array:
     const double x[] = { 1.0, -2.0, 3.0, -4.0, 5.0, -6.0, 7.0, -8.0 };
 
-    // Define prepend values:
+    // Define a list of values to prepend:
     const double p[] = { -1.0 };
 
-    // Define append values:
+    // Define a list of values to append:
     const double a[] = { 10.0 };
 
     // Define an output array:

lib/node_modules/@stdlib/blas/ext/base/ddiff/benchmark/benchmark.js

@@ -61,7 +61,7 @@ function createBenchmark( len ) {
 	N = len;
 	N1 = 1;
 	N2 = 1;
-	k = 1; // worst case: N + N1 + N2 - 1
+	k = 1;
 	ol = N + N1 + N2 - k;
 
 	x = uniform( N, -100, 100, options );

lib/node_modules/@stdlib/blas/ext/base/ddiff/benchmark/benchmark.native.js

@@ -66,7 +66,7 @@ function createBenchmark( len ) {
 	N = len;
 	N1 = 1;
 	N2 = 1;
-	k = 1; // worst case: N + N1 + N2 - 1
+	k = 1;
 	ol = N + N1 + N2 - k;
 
 	x = uniform( N, -100, 100, options );

lib/node_modules/@stdlib/blas/ext/base/ddiff/benchmark/benchmark.ndarray.js

@@ -61,7 +61,7 @@ function createBenchmark( len ) {
 	N = len;
 	N1 = 1;
 	N2 = 1;
-	k = 1; // worst case: N + N1 + N2 - 1
+	k = 1;
 	ol = N + N1 + N2 - k;
 
 	x = uniform( N, -100, 100, options );

lib/node_modules/@stdlib/blas/ext/base/ddiff/benchmark/benchmark.ndarray.native.js

@@ -66,7 +66,7 @@ function createBenchmark( len ) {
 	N = len;
 	N1 = 1;
 	N2 = 1;
-	k = 1; // worst case: N + N1 + N2 - 1
+	k = 1;
 	ol = N + N1 + N2 - k;
 
 	x = uniform( N, -100, 100, options );

lib/node_modules/@stdlib/blas/ext/base/ddiff/benchmark/c/benchmark.length.c

@@ -113,7 +113,7 @@ static double benchmark1( int iterations, int len ) {
 	N = len;
 	N1 = 1;
 	N2 = 1;
-	k = 1; // worst case: N + N1 + N2 - 1
+	k = 1;
 	ol = N + N1 + N2 - k;
 	wl = N + N1 + N2 - 1;
 
@@ -185,7 +185,7 @@ static double benchmark2( int iterations, int len ) {
 	N = len;
 	N1 = 1;
 	N2 = 1;
-	k = 1; // worst case: N + N1 + N2 - 1
+	k = 1;
 	ol = N + N1 + N2 - k;
 	wl = N + N1 + N2 - 1;
 

lib/node_modules/@stdlib/blas/ext/base/ddiff/docs/repl.txt

@@ -43,13 +43,13 @@
         Stride length for `append`.
 
     out: Float64Array
-        Output array. Must have `N + N1 + N2 - k` elements.
+        Output array. Must have `N + N1 + N2 - k` indexed elements.
 
     so: integer
         Stride length for `out`.
 
     w: Float64Array
-        Workspace array. Must have `N + N1 + N2 - 1` elements.
+        Workspace array. Must have `N + N1 + N2 - 1` indexed elements.
 
     sw: integer
         Stride length for `workspace`.
@@ -90,7 +90,7 @@
     <Float64Array>[ 3.0, 2.0, 2.0, 2.0, 1.0 ]
 
 
-{{alias}}.ndarray( N, k, x,sx,ox, N1,p,sp,op, N2,a,sa,oa, out,so,oo, w,sw,ow )
+{{alias}}.ndarray( N, k, x,sx,ox, N1, p,sp,op, N2, a,sa,oa, out,so,oo, w,sw,ow )
     Calculates the k-th discrete forward differences of a double-precision
     floating-point strided array using alternative indexing semantics.
 
@@ -140,7 +140,7 @@
         Starting index for `append`.
 
     out: Float64Array
-        Output array. Must have `N + N1 + N2 - k` elements.
+        Output array. Must have `N + N1 + N2 - k` indexed elements.
 
     so: integer
         Stride length for `out`.
@@ -149,7 +149,7 @@
         Starting index for `out`.
 
     w: Float64Array
-        Workspace array. Must have `N + N1 + N2 - 1` elements.
+        Workspace array. Must have `N + N1 + N2 - 1` indexed elements.
 
     sw: integer
         Stride length for `workspace`.

lib/node_modules/@stdlib/blas/ext/base/ddiff/docs/types/index.d.ts

@@ -29,10 +29,10 @@ interface Routine {
 	* @param k - number of times to recursively compute differences
 	* @param x - input array
 	* @param strideX - stride length for `x`
-	* @param N1 - number of indexed elements of prepend
+	* @param N1 - number of indexed elements for `prepend`
 	* @param prepend - prepend array
 	* @param strideP - stride length for `prepend`
-	* @param N2 - number of indexed elements of append
+	* @param N2 - number of indexed elements for `append`
 	* @param append - append array
 	* @param strideA - stride length for `append`
 	* @param out - output array
@@ -41,6 +41,11 @@ interface Routine {
 	* @param strideW - stride length for `workspace`
 	* @returns output array
 	*
+	* ## Notes
+	*
+	* -   The `out` array must have `N + N1 + N2 - k` elements.
+	* -   The `workspace` array must have `N + N1 + N2 - 1` elements.
+	*
 	* @example
 	* var Float64Array = require( '@stdlib/array/float64' );
 	*
@@ -65,11 +70,11 @@ interface Routine {
 	* @param x - input array
 	* @param strideX - stride length for `x`
 	* @param offsetX - starting index for `x`
-	* @param N1 - number of indexed elements of prepend
+	* @param N1 - number of indexed elements for `prepend`
 	* @param prepend - prepend array
 	* @param strideP - stride length for `prepend`
 	* @param offsetP - starting index for `prepend`
-	* @param N2 - number of indexed elements of append
+	* @param N2 - number of indexed elements for `append`
 	* @param append - append array
 	* @param strideA - stride length for `append`
 	* @param offsetA - starting index for `append`
@@ -81,6 +86,11 @@ interface Routine {
 	* @param offsetW - starting index for `workspace`
 	* @returns output array
 	*
+	* ## Notes
+	*
+	* -   The `out` array must have `N + N1 + N2 - k` elements.
+	* -   The `workspace` array must have `N + N1 + N2 - 1` elements.
+	*
 	* @example
 	* var Float64Array = require( '@stdlib/array/float64' );
 	*
@@ -105,10 +115,10 @@ interface Routine {
 * @param k - number of times to recursively compute differences
 * @param x - input array
 * @param strideX - stride length for `x`
-* @param N1 - number of indexed elements of prepend
+* @param N1 - number of indexed elements for `prepend`
 * @param prepend - prepend array
 * @param strideP - stride length for `prepend`
-* @param N2 - number of indexed elements of append
+* @param N2 - number of indexed elements for `append`
 * @param append - append array
 * @param strideA - stride length for `append`
 * @param out - output array
@@ -117,6 +127,11 @@ interface Routine {
 * @param strideW - stride length for `workspace`
 * @returns output array
 *
+* ## Notes
+*
+* -   The `out` array must have `N + N1 + N2 - k` elements.
+* -   The `workspace` array must have `N + N1 + N2 - 1` elements.
+*
 * @example
 * var Float64Array = require( '@stdlib/array/float64' );
 *

lib/node_modules/@stdlib/blas/ext/base/ddiff/examples/c/example.c

@@ -23,16 +23,16 @@ int main( void ) {
 	// Create a strided array:
 	const double x[] = { 1.0, -2.0, 3.0, -4.0, 5.0, -6.0, 7.0, -8.0 };
 
-	// Define prepend values:
+	// Define a list of values to prepend:
 	const double p[] = { -1.0 };
 
-	// Define append values:
+	// Define a list of values to append:
 	const double a[] = { 10.0 };
 
-	// Define an output array:
+	// Define the output array:
 	double out[] = { 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0 };
 
-	// Define a workspace:
+	// Define the workspace:
 	double w[] = { 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0 };
 
 	// Compute forward differences:

lib/node_modules/@stdlib/blas/ext/base/ddiff/include/stdlib/blas/ext/base/ddiff.h

@@ -31,12 +31,12 @@ extern "C" {
 /**
 * Calculates the k-th discrete forward differences of a double-precision floating-point strided array.
 */
-void API_SUFFIX(stdlib_strided_ddiff)( const CBLAS_INT N, const CBLAS_INT k, const double *X, const CBLAS_INT strideX, const CBLAS_INT N1, const double *Prepend, const CBLAS_INT strideP, const CBLAS_INT N2, const double *Append, const CBLAS_INT strideA, double *Out, const CBLAS_INT strideOut, double *Workspace, const CBLAS_INT strideW );
+void API_SUFFIX(stdlib_strided_ddiff)( const CBLAS_INT N, const CBLAS_INT k, const double *X, const CBLAS_INT strideX, const CBLAS_INT N1, const double *prepend, const CBLAS_INT strideP, const CBLAS_INT N2, const double *append, const CBLAS_INT strideA, double *out, const CBLAS_INT strideOut, double *workspace, const CBLAS_INT strideW );
 
 /**
 * Calculates the k-th discrete forward differences of a double-precision floating-point strided array using alternative indexing semantics.
 */
-void API_SUFFIX(stdlib_strided_ddiff_ndarray)( const CBLAS_INT N, const CBLAS_INT k, const double *X, const CBLAS_INT strideX, const CBLAS_INT offsetX, const CBLAS_INT N1, const double *Prepend, const CBLAS_INT strideP, const CBLAS_INT offsetP, const CBLAS_INT N2, const double *Append, const CBLAS_INT strideA, const CBLAS_INT offsetA, double *Out, const CBLAS_INT strideOut, const CBLAS_INT offsetOut, double *Workspace, const CBLAS_INT strideW, const CBLAS_INT offsetW );
+void API_SUFFIX(stdlib_strided_ddiff_ndarray)( const CBLAS_INT N, const CBLAS_INT k, const double *X, const CBLAS_INT strideX, const CBLAS_INT offsetX, const CBLAS_INT N1, const double *prepend, const CBLAS_INT strideP, const CBLAS_INT offsetP, const CBLAS_INT N2, const double *append, const CBLAS_INT strideA, const CBLAS_INT offsetA, double *out, const CBLAS_INT strideOut, const CBLAS_INT offsetOut, double *workspace, const CBLAS_INT strideW, const CBLAS_INT offsetW );
 
 
 #ifdef __cplusplus