Auto-generated commit

to-fancy/README.md

@@ -149,7 +149,8 @@ var v = y[ 10 ];
 
 ## Notes
 
--   A fancy array shares the **same** data as the provided input array. Hence, any mutations to the returned array will affect the underlying input array.
+-   A fancy array shares the **same** data as the provided input array. Hence, any mutations to the returned array will affect the underlying input array and vice versa.
+-   For operations returning a new array (e.g., when slicing or invoking an instance method), a fancy array returns a new fancy array having the same configuration as specified by `options`.
 -   A fancy array supports indexing using positive and negative integers (both numeric literals and strings), [`Slice`][@stdlib/slice/ctor] instances, and [subsequence expressions][@stdlib/slice/seq2slice].
 -   A fancy array supports all properties and methods of the input array, and, thus, a fancy array can be consumed by any API which supports array-like objects.
 -   Indexing expressions provide a convenient and powerful means for creating and operating on array views; however, their use does entail a performance cost. Indexing expressions are best suited for interactive use (e.g., in the [REPL][@stdlib/repl]) and scripting. For performance critical applications, prefer equivalent functional APIs supporting array-like objects.

to-fancy/docs/repl.txt

@@ -6,7 +6,12 @@
     indexing expressions for both retrieval and assignment.
 
     A fancy array shares the *same* data as the provided input array. Hence, any
-    mutations to the returned array will affect the underlying input array.
+    mutations to the returned array will affect the underlying input array and
+    vice versa.
+
+    For operations returning a new array (e.g., when slicing or invoking an
+    instance method), a fancy array returns a new fancy array having the same
+    configuration as specified by provided options.
 
     A fancy array supports indexing using positive and negative integers (both
     numeric literals and strings), Slice instances, and subsequence expressions.