docs: update examples and copy

Author: kgryte

lib/node_modules/@stdlib/string/for-each/README.md

@@ -42,16 +42,14 @@ var forEach = require( '@stdlib/string/for-each' );
 
 #### forEach( str, clbk\[, thisArg ] )
 
-Invokes a `function` for each (visual) character of a `string`.
+Invokes a function for each (visual) character of a string.
 
 ```javascript
 function log( value, index ) {
-    console.log( '%s: %d', index, value );
+    console.log( '%d: %s', index, value );
 }
 
-var str = 'Hello World!';
-
-forEach( str, log );
+forEach( 'Hello, world!', log );
 /* =>
     0: H
     1: e
@@ -68,76 +66,28 @@ forEach( str, log );
 */
 ```
 
-The invoked `function` is provided three arguments:
-
--   `value`: visual character.
--   `index`: starting character index.
--   `str`: input string.
-
-```javascript
-function log1( value, index ) {
-    var repeatVal = value + value;
-    console.log( '%s: %d', index, repeatVal );
-}
+The invoked function is provided three arguments:
 
-var str1 = 'Hello World!';
-
-forEach( str1, log1 );
-/* =>
-    0: HH
-    1: ee
-    2: ll
-    3: ll
-    4: oo
-    5:
-    6: WW
-    7: oo
-    8: rr
-    9: ll
-    10: dd
-    11: !!
-*/
-
-function log2( value, index ) {
-    var upperCased = value.toUpperCase();
-    console.log( '%s: %d', index, upperCased );
-}
-
-var str2 = 'hello world!';
-
-forEach( str2, log2 );
-/* =>
-    0: H
-    1: E
-    2: L
-    3: L
-    4: O
-    5:
-    6: W
-    7: O
-    8: R
-    9: L
-    10: D
-    11: !
-*/
-```
+-   `value`: visual character
+-   `index`: starting character index
+-   `str`: input string
 
 To set the function execution context, provide a `thisArg`.
 
 ```javascript
-function count( value ) {
+function clbk() {
     this.count += 1;
 }
 
-var str3 = 'hello world!';
+var str = 'Hello, world!';
 
-var context = {
+var ctx = {
     'count': 0
 };
 
-forEach( str3, count, context );
+forEach( str, clbk, ctx );
 
-var bool = str3.length === context.count;
+var bool = ( str.length === ctx.count );
 // returns true
 ```
 
@@ -149,27 +99,6 @@ var bool = str3.length === context.count;
 
 <section class="notes">
 
-## Notes
-
--   The function differs from traditional string iterations in the following ways:
-
-    -   The function returns the input `str`.
-
-    -   The `clbk` is executed on each _visual_ character as opposed to being executed on each character.
-
-        ```javascript
-        function log( value, index ) {
-            console.log( '%s: %s', index, value );
-        }
-
-        var str = '\uD834\uDD1E';
-
-        forEach( str, log );
-        /* =>
-            0: 𝄞
-        */
-        ```
-
 </section>
 
 <!-- /.notes -->
@@ -183,19 +112,16 @@ var bool = str3.length === context.count;
 <!-- eslint no-undef: "error" -->
 
 ```javascript
-var isEven = require( '@stdlib/assert/is-even' ).isPrimitive;
 var forEach = require( '@stdlib/string/for-each' );
 
 function log( value, index ) {
-    if ( isEven( index ) ) {
-        console.log( '%s: %d', index, '*' );
-    } else {
-        console.log( '%s: %d', index, value );
-    }
+    console.log( '%d: %s', index, value );
 }
 
-var str4 = 'Javascript';
-forEach( str4, log );
+forEach( 'presidential election', log );
+forEach( 'Iñtërnâtiônàlizætiøn', log );
+forEach( '🌷🍕', log );
+forEach( '\uD834\uDD1E', log );
 ```
 
 </section>
@@ -214,13 +140,6 @@ forEach( str4, log );
 
 <section class="related">
 
-* * *
-
-## See Also
-
--   <span class="package-name">[`@stdlib/utils/for-each`][@stdlib/utils/for-each]</span><span class="delimiter">: </span><span class="description">invoke a function once for each element in a collection.</span>
--   <span class="package-name">[`@stdlib/utils/async/for-each`][@stdlib/utils/async/for-each]</span><span class="delimiter">: </span><span class="description">invoke an async function once for each element in a collection.</span>
-
 </section>
 
 <!-- /.related -->
@@ -229,14 +148,6 @@ forEach( str4, log );
 
 <section class="links">
 
-<!-- <related-links> -->
-
-[@stdlib/utils/for-each]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/utils/for-each
-
-[@stdlib/utils/async/for-each]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/utils/async/for-each
-
-<!-- </related-links> -->
-
 </section>
 
 <!-- /.links -->