Adds some hint to the readme and simplifies example code

Author: jtkDvlp

README.md

@@ -24,6 +24,8 @@ Add the following dependency to your `project.clj`:<br>
 
 ### Usage
 
+Pay attention mixing up error propagation functions of this library and clojure.core.async functions. clojure.core.async function do not propagate errors. E.g. using a core.async go-block within a error propagation go-block stack will break error propagation. So do not mix it up!
+
 ```clojure
 (ns your-project
   #?(:clj
@@ -34,10 +36,16 @@ Add the following dependency to your `project.clj`:<br>
      :cljs
      (:require
       [cljs.core.async :refer [timeout]]
-      [jtk-dvlp.async :as a])))
+      [jtk-dvlp.async :as a]))
+
+  #?(:clj
+     (:import
+      [clojure.lang ExceptionInfo]))
 
+  ,,,)
 
-(defn ?do-some-async-stuff
+
+(defn <do-some-async-stuff
   [& args]
   (a/go
     (a/<! (timeout 1000))
@@ -47,37 +55,32 @@ Add the following dependency to your `project.clj`:<br>
       (println result)
       result)))
 
-(defn ?fail-during-some-async-stuff
+(defn <fail-during-some-async-stuff
   [& args]
   (a/go
     (a/<! (timeout 1000))
     (->> {:call-args args}
          (ex-info "you got a bug")
          (throw))))
 
-(defn ?do-some-more-stuff
-  []
+(comment
   (a/go
-    (let [a
-          (a/<! (?do-some-async-stuff :a))
+    (try
+      (let [a
+            (a/<! (<do-some-async-stuff :a))
 
-          b
-          (a/<! (?fail-during-some-async-stuff :b))
+            b
+            (a/<! (<fail-during-some-async-stuff :b))
 
-          c
-          (a/<! (?do-some-async-stuff :c))]
+            c
+            (a/<! (<do-some-async-stuff :c))]
 
-      [a b c])))
+        (println [a b c]))
 
-(comment
-  (a/go
-    (try
-      (->> (?do-some-more-stuff)
-           (a/<!)
-           (println "success"))
-      (catch #?(:clj Throwable
-                :cljs :default) e
-        (println "there is an error" e)))))
+      (catch ExceptionInfo e
+        (println "there is an error" e))))
+
+  ,,,)
 ```
 
 

dev/your_project.cljc

@@ -12,10 +12,11 @@
   #?(:clj
      (:import
       [clojure.lang ExceptionInfo]))
-  )
 
+  ,,,)
 
-(defn ?do-some-async-stuff
+
+(defn <do-some-async-stuff
   [& args]
   (a/go
     (a/<! (timeout 1000))
@@ -25,34 +26,29 @@
       (println result)
       result)))
 
-(defn ?fail-during-some-async-stuff
+(defn <fail-during-some-async-stuff
   [& args]
   (a/go
     (a/<! (timeout 1000))
     (->> {:call-args args}
          (ex-info "you got a bug")
          (throw))))
 
-(defn ?do-some-more-stuff
-  []
+(comment
   (a/go
-    (let [a
-          (a/<! (?do-some-async-stuff :a))
+    (try
+      (let [a
+            (a/<! (<do-some-async-stuff :a))
 
-          b
-          (a/<! (?fail-during-some-async-stuff :b))
+            b
+            (a/<! (<fail-during-some-async-stuff :b))
 
-          c
-          (a/<! (?do-some-async-stuff :c))]
+            c
+            (a/<! (<do-some-async-stuff :c))]
 
-      [a b c])))
+        (println [a b c]))
 
-(comment
-  (a/go
-    (try
-      (->> (?do-some-more-stuff)
-           (a/<!)
-           (println "success"))
-      (catch #?(:clj ExceptionInfo
-                :cljs :default) e
-        (println "there is an error" e)))))
+      (catch ExceptionInfo e
+        (println "there is an error" e))))
+
+  ,,,)