Apply suggestions from code review

Signed-off-by: Athan <[email protected]>

Author: kgryte

lib/node_modules/@stdlib/blas/base/dsyr/README.md

@@ -75,14 +75,14 @@ Note that indexing is relative to the first index. To introduce an offset, use [
 var Float64Array = require( '@stdlib/array/float64' );
 
 // Initial arrays...
-var x0 = new Float64Array( [ 1.0, 1.0, 1.0, 1.0 ] );
+var x0 = new Float64Array( [ 0.0, 3.0, 2.0, 1.0 ] );
 var A = new Float64Array( [ 1.0, 2.0, 3.0, 2.0, 1.0, 2.0, 3.0, 2.0, 1.0 ] );
 
 // Create offset views...
 var x1 = new Float64Array( x0.buffer, x0.BYTES_PER_ELEMENT*1 ); // start at 2nd element
 
 dsyr( 'row-major', 'upper', 3, 1.0, x1, -1, A, 3 );
-// A => <Float64Array>[ 2.0, 3.0, 4.0, 2.0, 2.0, 3.0, 3.0, 2.0, 2.0 ]
+// A => <Float64Array>[ 2.0, 4.0, 6.0, 2.0, 5.0, 8.0, 3.0, 2.0, 10.0 ]
 ```
 
 #### dsyr.ndarray( uplo, N, α, x, sx, ox, A, sa1, sa2, oa )
@@ -149,10 +149,11 @@ var opts = {
 
 var N = 3;
 
-// Define 3x3 symmetric matrices:
+// Create N-by-N symmetric matrices:
 var A1 = ones( N*N, opts.dtype );
 var A2 = ones( N*N, opts.dtype );
 
+// Create a random vector:
 var x = discreteUniform( N, -10.0, 10.0, opts );
 
 dsyr( 'row-major', 'upper', 3, 1.0, x, 1, A1, 3 );
@@ -217,7 +218,7 @@ The function accepts the following arguments:
 -   **LDA**: `[in] CBLAS_INT` stride of the first dimension of `A` (a.k.a., leading dimension of the matrix `A`).
 
 ```c
-void c_dsyr( const CBLAS_LAYOUT layout, const CBLAS_UPLO uplo, const CBLAS_INT N, const double alpha, const double *x, const CBLAS_INT strideX, double *A, const CBLAS_INT LDA )
+void c_dsyr( const CBLAS_LAYOUT layout, const CBLAS_UPLO uplo, const CBLAS_INT N, const double alpha, const double *X, const CBLAS_INT strideX, double *A, const CBLAS_INT LDA )
 ```
 
 #### c_dsyr_ndarray( uplo, N, alpha, \*X, sx, ox, \*A, sa1, sa2, oa )
@@ -247,7 +248,7 @@ The function accepts the following arguments:
 -   **oa**: `[in] CBLAS_INT` starting index for `A`.
 
 ```c
-void c_dsyr_ndarray( const CBLAS_UPLO uplo, const CBLAS_INT N, const double alpha, const double *x, const CBLAS_INT strideX, const CBLAS_INT offsetX, double *A, const CBLAS_INT strideA1, const CBLAS_INT strideA2, const CBLAS_INT offsetA )
+void c_dsyr_ndarray( const CBLAS_UPLO uplo, const CBLAS_INT N, const double alpha, const double *X, const CBLAS_INT strideX, const CBLAS_INT offsetX, double *A, const CBLAS_INT strideA1, const CBLAS_INT strideA2, const CBLAS_INT offsetA )
 ```
 
 </section>
@@ -301,7 +302,7 @@ int main( void ) {
         printf( "A1[ %i ] = %f\n", i, A1[ i ] );
     }
 
-    // Perform the symmetric rank 1 operation `A = α*x*x^T + A` using alternative semantics indexing:
+    // Perform the symmetric rank 1 operation `A = α*x*x^T + A` using alternative indexing semantics:
     c_dsyr_ndarray( CblasUpper, N, 1.0, x, 1, 0, A2, N, 1, 0 );
 
     // Print the result: