Edit docs

Author: bluss

README.rst

@@ -53,10 +53,14 @@ Status and Lookout
 
 - Performance status:
 
-  + Arithmetic involving arrays of contiguous inner dimension optimizes very well.
-  + ``.fold()`` and ``.zip_mut_with()`` are the most efficient ways to
+  + Performance of an operation depends on the memory layout of the array
+    or array view. Especially important if it's a binary operation, which
+    needs the two arrays to match to be efficient (in most cases).
+  + Arithmetic optimizes very well if the arrays are have contiguous inner dimension.
+  + The callback based methods like ``.mapv()``, ``.applyv()`` and
+    ``.zip_mut_with()`` are the most efficient ways to
     perform single traversal and lock step traversal respectively.
-  + ``.iter()`` and ``.iter_mut()`` are efficient for contiguous arrays.
+  + ``.iter()`` is efficient for c-contiguous arrays.
   + Can use BLAS in some operations (``dot`` and ``mat_mul``).
 
 Crate Feature Flags

src/lib.rs

@@ -43,10 +43,14 @@
 //!     *will be deprecated* when Rust supports `+=` and similar in Rust 1.8.
 //!   + We try to introduce more static checking gradually.
 //! - Performance status:
-//!   + Arithmetic involving arrays of contiguous inner dimension optimizes very well.
-//!   + `.fold()` and `.zip_mut_with()` are the most efficient ways to
+//!   + Performance of an operation depends on the memory layout of the array
+//!     or array view. Especially important if it's a binary operation, which
+//!     needs the two arrays to match to be efficient (in most cases).
+//!   + Arithmetic optimizes very well if the arrays are have contiguous inner dimension.
+//!   + The callback based methods like ``.mapv()``, ``.applyv()`` and
+//!     ``.zip_mut_with()`` are the most efficient ways to
 //!     perform single traversal and lock step traversal respectively.
-//!   + `.iter()` and `.iter_mut()` are efficient for contiguous arrays.
+//!   + ``.iter()`` is efficient for c-contiguous arrays.
 //!   + Can use BLAS in some operations (`dot` and `mat_mul`).
 //!
 //! ## Crate Feature Flags