chore: update according to 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: passed
  - 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: passed
  - task: lint_javascript_benchmarks
    status: na
  - task: lint_python
    status: na
  - task: lint_r
    status: na
  - task: lint_c_src
    status: passed
  - 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: passed
  - task: lint_license_headers
    status: passed
---

Author: nakul-krishnakumar

lib/node_modules/@stdlib/stats/strided/distances/dcosine-similarity/README.md

@@ -18,12 +18,27 @@ limitations under the License.
 
 -->
 
-# dcosine-similarity
+# dcosineSimilarity
 
-> Computes the cosine similarity of two double-precision floating-point vectors.
+> Compute the cosine similarity of two double-precision floating-point strided arrays.
 
 <section class="intro">
 
+The [cosine similarity][wikipedia-cosine-similarity] is defined as
+
+<!-- <equation class="equation" label="eq:cosine_similarity" align="center"
+raw="sim=\frac{A\cdot B}{\|A\|\|B\|} alt="Equation for cosine similarity."> -->
+
+```math
+sim = \frac{A \cdot B}{\|A\| \, \|B\|}
+```
+
+<!-- <div class="equation" align="center" data-raw-text="sim=\frac{A\cdot B}{\|A\|\|B\|} data-equation="eq:cosine_similarity"> <img src="" alt="Cosine similarity equation."> <br> 
+
+</div> --> 
+
+<!-- </equation> -->
+
 </section>
 
 <!-- /.intro -->
@@ -38,7 +53,7 @@ var dcosineSimilarity = require( '@stdlib/stats/strided/distances/dcosine-simila
 
 #### dcosineSimilarity( N, x, strideX, y, strideY )
 
-Calculates the cosine similarity of vectors `x` and `y`.
+Computes the cosine similarity of two double-precision floating-point strided arrays.
 
 ```javascript
 var Float64Array = require( '@stdlib/array/float64' );
@@ -58,7 +73,7 @@ The function has the following parameters:
 -   **y**: input [`Float64Array`][@stdlib/array/float64].
 -   **strideY**: stride length of `y`.
 
-The `N` and strides parameters determine which elements in the strided arrays are accessed at runtime. For example, to calculate the cosine similarity of every other value in `x` and the first `N` elements of `y` in reverse order,
+The `N` and stride parameters determine which elements in the strided arrays are accessed at runtime. For example, to calculate the cosine similarity of every other value in `x` and the first `N` elements of `y` in reverse order,
 
 ```javascript
 var Float64Array = require( '@stdlib/array/float64' );
@@ -91,7 +106,7 @@ var z = dcosineSimilarity( 3, x1, 1, y1, 1 );
 
 #### dcosineSimilarity.ndarray( N, x, strideX, offsetX, y, strideY, offsetY )
 
-Calculates the cosine similarity of `x` and `y` using alternative indexing semantics.
+Computes the cosine similarity of two double-precision floating-point strided arrays using alternative indexing semantics.
 
 ```javascript
 var Float64Array = require( '@stdlib/array/float64' );
@@ -189,7 +204,7 @@ console.log( out );
 
 #### stdlib_strided_dcosine_similarity( N, \*X, strideX, \*Y, strideY )
 
-Computes the cosine similarity of two double-precision floating-point vectors.
+Computes the cosine similarity of two double-precision floating-point strided arrays.
 
 ```c
 const double x[] = { 4.0, 2.0, -3.0, 5.0, -1.0 };
@@ -211,13 +226,13 @@ The function accepts the following arguments:
 double stdlib_strided_dcosine_similarity( const CBLAS_INT N, const double *X, const CBLAS_INT strideX, const double *Y, const CBLAS_INT strideY );
 ```
 
-<!--lint ignore maximum-heading-length-->
+<!--lint disable maximum-heading-length-->
 
 #### stdlib_strided_dcosine_similarity_ndarray( N, \*X, strideX, offsetX, \*Y, strideY, offsetY )
 
-<!--lint ignore maximum-heading-length-->
+<!--lint enable maximum-heading-length-->
 
-Computes the cosine similarity of two double-precision floating-point vectors using alternative indexing semantics.
+Computes the cosine similarity of two double-precision floating-point strided arrays using alternative indexing semantics.
 
 ```c
 const double x[] = { 4.0, 2.0, -3.0, 5.0, -1.0 };
@@ -313,6 +328,8 @@ int main( void ) {
 
 [mdn-typed-array]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/TypedArray
 
+[wikipedia-cosine-similarity]: https://en.wikipedia.org/wiki/Cosine_similarity
+
 <!-- <related-links> -->
 
 <!-- </related-links> -->

lib/node_modules/@stdlib/stats/strided/distances/dcosine-similarity/docs/repl.txt

@@ -1,7 +1,7 @@
 
 {{alias}}( N, x, strideX, y, strideY )
     Computes the cosine similarity of two double-precision
-    floating-point vectors.
+    floating-point strided arrays.
 
     The `N` and stride parameters determine which elements in the strided arrays
     are accessed at runtime.
@@ -58,7 +58,7 @@
 
 {{alias}}.ndarray( N, x, strideX, offsetX, y, strideY, offsetY )
     Computes the cosine similarity of two double-precision
-    floating-point vectors using alternative indexing semantics.
+    floating-point strided arrays using alternative indexing semantics.
 
     While typed array views mandate a view offset based on the underlying
     buffer, the offset parameters support indexing based on a starting index.

lib/node_modules/@stdlib/stats/strided/distances/dcosine-similarity/docs/types/index.d.ts

@@ -23,7 +23,7 @@
 */
 interface Routine {
 	/**
-	* Computes the cosine similarity of two double-precision floating-point vectors.
+	* Computes the cosine similarity of two double-precision floating-point strided arrays.
 	*
 	* @param N - number of indexed elements
 	* @param x - first input array
@@ -44,7 +44,7 @@ interface Routine {
 	( N: number, x: Float64Array, strideX: number, y: Float64Array, strideY: number ): number;
 
 	/**
-	* Computes the cosine similarity of two double-precision floating-point vectors using alternative indexing semantics.
+	* Computes the cosine similarity of two double-precision floating-point strided arrays using alternative indexing semantics.
 	*
 	* @param N - number of indexed elements
 	* @param x - first input array
@@ -68,7 +68,7 @@ interface Routine {
 }
 
 /**
-* Computes the cosine similarity of two double-precision floating-point vectors.
+* Computes the cosine similarity of two double-precision floating-point strided arrays.
 *
 * @param N - number of indexed elements
 * @param x - first input array

lib/node_modules/@stdlib/stats/strided/distances/dcosine-similarity/include/stdlib/stats/strided/distances/dcosine_similarity.h

@@ -16,8 +16,8 @@
 * limitations under the License.
 */
 
-#ifndef STDLIB_STATS_STRIDED_DCOSINE_SIMILARITY_H
-#define STDLIB_STATS_STRIDED_DCOSINE_SIMILARITY_H
+#ifndef STDLIB_STATS_STRIDED_DISTANCES_DCOSINE_SIMILARITY_H
+#define STDLIB_STATS_STRIDED_DISTANCES_DCOSINE_SIMILARITY_H
 
 #include "stdlib/blas/base/shared.h"
 
@@ -29,17 +29,17 @@ extern "C" {
 #endif
 
 /**
-* Computes the cosine similarity of two double-precision floating-point vectors.
+* Computes the cosine similarity of two double-precision floating-point strided arrays.
 */
 double API_SUFFIX( stdlib_strided_dcosine_similarity )( const CBLAS_INT N, const double *X, const CBLAS_INT strideX, const double *Y, const CBLAS_INT strideY );
 
 /**
-* Computes the cosine similarity of two double-precision floating-point vectors using alternative indexing semantics.
+* Computes the cosine similarity of two double-precision floating-point strided arrays using alternative indexing semantics.
 */
 double API_SUFFIX( stdlib_strided_dcosine_similarity_ndarray )( const CBLAS_INT N, const double *X, const CBLAS_INT strideX, const CBLAS_INT offsetX, const double *Y, const CBLAS_INT strideY, const CBLAS_INT offsetY );
 
 #ifdef __cplusplus
 }
 #endif
 
-#endif // !STDLIB_STATS_STRIDED_DCOSINE_SIMILARITY_H
+#endif // !STDLIB_STATS_STRIDED_DISTANCES_DCOSINE_SIMILARITY_H

lib/node_modules/@stdlib/stats/strided/distances/dcosine-similarity/lib/dcosine_similarity.js

@@ -27,9 +27,9 @@ var ndarray = require( './ndarray.js' );
 // MAIN //
 
 /**
-* Computes the cosine similarity of two double-precision floating-point vectors.
+* Computes the cosine similarity of two double-precision floating-point strided arrays.
 *
-* @param {integer} N - number of indexed elements
+* @param {NonNegativeInteger} N - number of indexed elements
 * @param {Float64Array} x - first input array
 * @param {integer} strideX - stride length of `x`
 * @param {Float64Array} y - second input array

lib/node_modules/@stdlib/stats/strided/distances/dcosine-similarity/lib/dcosine_similarity.native.js

@@ -26,9 +26,9 @@ var addon = require( './../src/addon.node' );
 // MAIN //
 
 /**
-* Computes the cosine similarity of two double-precision floating-point vectors.
+* Computes the cosine similarity of two double-precision floating-point strided arrays.
 *
-* @param {integer} N - number of indexed elements
+* @param {NonNegativeInteger} N - number of indexed elements
 * @param {Float64Array} x - first input array
 * @param {integer} strideX - stride length of `x`
 * @param {Float64Array} y - second input array

lib/node_modules/@stdlib/stats/strided/distances/dcosine-similarity/lib/index.js

@@ -19,7 +19,7 @@
 'use strict';
 
 /**
-* Compute the cosine similarity of two double-precision floating-point vectors.
+* Compute the cosine similarity of two double-precision floating-point strided arrays.
 *
 * @module @stdlib/stats/strided/distances/dcosine-similarity
 *

lib/node_modules/@stdlib/stats/strided/distances/dcosine-similarity/lib/ndarray.js

@@ -27,9 +27,9 @@ var dnrm2 = require( '@stdlib/blas/base/dnrm2' ).ndarray;
 // MAIN //
 
 /**
-* Computes the cosine similarity of two double-precision floating-point vectors using alternative indexing semantics.
+* Computes the cosine similarity of two double-precision floating-point strided arrays using alternative indexing semantics.
 *
-* @param {integer} N - number of indexed elements
+* @param {NonNegativeInteger} N - number of indexed elements
 * @param {Float64Array} x - first input array
 * @param {integer} strideX - stride length of `x`
 * @param {NonNegativeInteger} offsetX - starting index for `x`
@@ -50,18 +50,15 @@ var dnrm2 = require( '@stdlib/blas/base/dnrm2' ).ndarray;
 function dcosineSimilarity( N, x, strideX, offsetX, y, strideY, offsetY ) {
 	var ynrm;
 	var xnrm;
-	var num;
-	var den;
+	var dot;
 
 	if (N <= 0) {
 		return 0.0;
 	}
-
-	num = ddot( N, x, strideX, offsetX, y, strideY, offsetY );
+	dot = ddot( N, x, strideX, offsetX, y, strideY, offsetY );
 	xnrm = dnrm2( N, x, strideX, offsetX );
 	ynrm = dnrm2( N, y, strideY, offsetY );
-	den = xnrm * ynrm;
-	return num / den;
+	return dot / ( xnrm * ynrm );
 }
 
 

lib/node_modules/@stdlib/stats/strided/distances/dcosine-similarity/lib/ndarray.native.js

@@ -26,9 +26,9 @@ var addon = require( './../src/addon.node' );
 // MAIN //
 
 /**
-* Computes the cosine similarity of two double-precision floating-point vectors using alternative indexing semantics.
+* Computes the cosine similarity of two double-precision floating-point strided arrays using alternative indexing semantics.
 *
-* @param {integer} N - number of indexed elements
+* @param {NonNegativeInteger} N - number of indexed elements
 * @param {Float64Array} x - first input array
 * @param {integer} strideX - stride length of `x`
 * @param {NonNegativeInteger} offsetX - starting index for `x`

lib/node_modules/@stdlib/stats/strided/distances/dcosine-similarity/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stdlib/stats/strided/distances/dcosine-similarity",
   "version": "0.0.0",
-  "description": "Computes the cosine similarity of two double-precision floating-point vectors.",
+  "description": "Compute the cosine similarity of two double-precision floating-point strided arrays.",
   "license": "Apache-2.0",
   "author": {
     "name": "The Stdlib Authors",