docs: add notes

Author: kgryte

lib/node_modules/@stdlib/ndarray/base/broadcast-scalar/README.md

@@ -69,6 +69,8 @@ var v = x.get( 0, 0 );
 ## Notes
 
 -   If `value` is a number and [`dtype`][@stdlib/ndarray/dtypes] is a complex [data type][@stdlib/ndarray/dtypes], the function returns an [`ndarray`][@stdlib/ndarray/base/ctor] containing a complex number whose real component equals the provided scalar `value` and whose imaginary component is zero.
+-   The returned [ndarray][@stdlib/ndarray/base/ctor] is a view on an [ndarray][@stdlib/ndarray/base/ctor] data buffer containing a single element. The view is **not** contiguous. As more than one element of a returned view may refer to the same memory location, writing to the view may affect multiple elements. If you need to write to the returned [ndarray][@stdlib/ndarray/base/ctor], copy the [ndarray][@stdlib/ndarray/base/ctor] **before** performing operations which may mutate elements.
+-   The returned [ndarray][@stdlib/ndarray/base/ctor] is a "base" [ndarray][@stdlib/ndarray/base/ctor], and, thus, the returned [ndarray][@stdlib/ndarray/base/ctor] does not perform bounds checking or afford any of the guarantees of the non-base [ndarray][@stdlib/ndarray/ctor] constructor. The primary intent of this function is to broadcast a scalar value as an [`ndarray`][@stdlib/ndarray/base/ctor] within internal implementations and to do so with minimal overhead.
 
 </section>
 
@@ -124,6 +126,8 @@ for ( i = 0; i < dt.length; i++ ) {
 
 [@stdlib/ndarray/base/ctor]: https://github.com/stdlib-js/stdlib
 
+[@stdlib/ndarray/ctor]: https://github.com/stdlib-js/stdlib
+
 [@stdlib/ndarray/dtypes]: https://github.com/stdlib-js/stdlib
 
 </section>

lib/node_modules/@stdlib/ndarray/base/broadcast-scalar/docs/repl.txt

@@ -6,6 +6,18 @@
     function returns an ndarray containing a complex number whose real component
     equals the provided scalar value and whose imaginary component is zero.
 
+    The returned array is a view on an ndarray data buffer. The view is *not*
+    contiguous. As more than one element of a returned view may refer to the
+    same memory location, writing to the view may affect multiple elements. If
+    you need to write to the returned array, copy the array before performing
+    operations which may mutate elements.
+
+    The returned array is a "base" ndarray, and, thus, the returned array does
+    not perform bounds checking or afford any of the guarantees of the non-base
+    ndarray constructor. The primary intent of this function is to broadcast a
+    scalar value as an ndarray within internal implementations and to do so with
+    minimal overhead.
+
     Parameters
     ----------
     value: any