docs: add note and update copy

---
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: 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: na
  - task: lint_typescript_tests
    status: na
  - task: lint_license_headers
    status: passed
---

Author: kgryte

lib/node_modules/@stdlib/ndarray/fill-by/README.md

@@ -20,7 +20,7 @@ limitations under the License.
 
 # fillBy
 
-> Fill an input [`ndarray`][@stdlib/ndarray/ctor] according to a callback function.
+> Fill an input [ndarray][@stdlib/ndarray/ctor] according to a callback function.
 
 <section class="intro">
 
@@ -38,7 +38,7 @@ var fillBy = require( '@stdlib/ndarray/fill-by' );
 
 #### fillBy( x, fcn\[, thisArg] )
 
-Fills an input [`ndarray`][@stdlib/ndarray/ctor] according to a callback function.
+Fills an input [ndarray][@stdlib/ndarray/ctor] according to a callback function.
 
 ```javascript
 var zeros = require( '@stdlib/ndarray/zeros' );
@@ -64,7 +64,7 @@ var arr = ndarray2array( y );
 
 The function accepts the following arguments:
 
--   **x**: array-like object containing an input [`ndarray`][@stdlib/ndarray/ctor].
+-   **x**: array-like object containing an input [ndarray][@stdlib/ndarray/ctor].
 -   **fcn**: callback function.
 -   **thisArg**: callback function execution context (_optional_).
 
@@ -94,6 +94,12 @@ var arr = ndarray2array( y );
 // returns [ [ [ 10.0, 10.0 ] ], [ [ 10.0, 10.0 ] ], [ [ 10.0, 10.0 ] ] ]
 ```
 
+The callback function is provided the following arguments:
+
+-   **value**: current [ndarray][@stdlib/ndarray/ctor] element.
+-   **indices**: current [ndarray][@stdlib/ndarray/ctor] element indices.
+-   **arr**: the input [ndarray][@stdlib/ndarray/ctor].
+
 </section>
 
 <!-- /.usage -->
@@ -102,8 +108,9 @@ var arr = ndarray2array( y );
 
 ## Notes
 
--   An input [`ndarray`][@stdlib/ndarray/ctor] **must** be writable. If provided a **read-only** [`ndarray`][@stdlib/ndarray/ctor], the function throws an error.
--   The function **mutates** the input [`ndarray`][@stdlib/ndarray/ctor].
+-   An input [ndarray][@stdlib/ndarray/ctor] **must** be writable. If provided a **read-only** [ndarray][@stdlib/ndarray/ctor], the function throws an error.
+-   The function **mutates** the input [ndarray][@stdlib/ndarray/ctor].
+-   The function assumes that each element in the underlying input [ndarray][@stdlib/ndarray/ctor] data buffer has one, and only one, corresponding element in input [ndarray][@stdlib/ndarray/ctor] view (i.e., a provided [ndarray][@stdlib/ndarray/ctor] is not a broadcasted [ndarray][@stdlib/ndarray/ctor] view).
 
 </section>
 

lib/node_modules/@stdlib/ndarray/fill-by/docs/repl.txt

@@ -4,6 +4,16 @@
 
     The function *mutates* the input ndarray.
 
+    The function assumes that each element in the underlying input ndarray data
+    buffer has one, and only one, corresponding element in input ndarray view
+    (i.e., a provided ndarray is not a broadcasted ndarray view).
+
+    The callback function is provided the following arguments:
+
+    - value: current array element.
+    - indices: current array element indices.
+    - arr: the input ndarray.
+
     Parameters
     ----------
     x: ndarrayLike