Nitpicks in the new example

README.md

@@ -1888,57 +1888,60 @@ tuple()
 
 1\.
 ```py
-def func(k):
+def some_func(x):
-    if k == 3:
+    if x == 3:
-        return ["A string..."]
+        return ["wtf"]
     else:
-        yield from range(k)
+        yield from range(x)
 ```
 
 **Output:**
 ```py
->>> list(func(3))  # expected: ["A string..."]
+>>> list(some_func(3))
 []
 ```
 
-The same behavior is true if we rewrite `yield from` as a for loop.
+Where did the `"wtf"` go? Is it due to some special effect of `yield from`? Let's validate that,
 
 2\.
 ```py
-def func(k):
+def some_func(x):
-    if k == 3:
+    if x == 3:
-        return ["A string..."]
+        return ["wtf"]
     else:
-        for j in range(k):
+        for i in range(x):
-            yield j
+          yield i
 ```
 
 **Output:**
 ```py
->>> list(func(3))  # expected: ["A string..."]
+>>> list(some_func(3))
 []
 ```
 
+Same result, that didn't work either.
+
 #### 💡 Explanation:
 
-Starting from Python 3.3+ it became possible to use return statement 
++ From Python 3.3 onwards, it became possible to use `return` statement with values inside generators (See [PEP380](https://www.python.org/dev/peps/pep-0380/)). The [official docs](https://www.python.org/dev/peps/pep-0380/#enhancements-to-stopiteration) say that,
-with values inside generators ([PEP380](https://www.python.org/dev/peps/pep-0380/)). The [official doc](https://www.python.org/dev/peps/pep-0380/#enhancements-to-stopiteration) says that "... `return expr` in a generator causes `StopIteration(expr)` to be raised upon exit from the generator." 
 
-So, to get `["A string..."]` from the generator `func` we need to catch `StopIteration`, e.g.:
+> "... `return expr` in a generator causes `StopIteration(expr)` to be raised upon exit from the generator."
 
++ In case of `some_func(3)`, `StopIteration` is raised at the beginning because of `return` statement. The `StopIteration` exception is automatically catched inside the `list(...)` wrapper and the `for` loop. Therefore, the above two snippets result in an empty list.
+
++ To get `["wtf"]` from the generator `some_func` we need to catch the `StopIteration` exception,
   ```py
   try:
-    next(func(3))
+      next(some_func(3))
   except StopIteration as e:
-    string = e.value
+      some_string = e.value
   ```
 
   ```py
->>> string
+  >>> some_string
-['A string...']
+  ["wtf"]
   ```
 
-Note that `list(...)` automatically catches `StopIteration`. In case of `func(3)` `StopIteration` raises at the beginning because of `return` statement. Therefore, `list(func(3))` results in an empty list.
 
 ---