diff --git a/to-fancy/README.md b/to-fancy/README.md index 3b03ae4a..ed225622 100644 --- a/to-fancy/README.md +++ b/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. diff --git a/to-fancy/docs/repl.txt b/to-fancy/docs/repl.txt index 6ca7b657..a4ed2de2 100644 --- a/to-fancy/docs/repl.txt +++ b/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.