diff --git a/src/re_frame/router.cljs b/src/re_frame/router.cljs
index 6f81d82..9780509 100644
--- a/src/re_frame/router.cljs
+++ b/src/re_frame/router.cljs
@@ -137,9 +137,10 @@
     (let [[new-state action-fn]
           (case [fsm-state trigger]
 
-            ; Here is the FSM
-            ;[current-state :trigger]  [:new-state  action-fn]
+            ;; Here is the FSM
+            ;; [current-state trigger] [new-state action-fn]
 
+            ;; the queue is idle
             [:quiescent :add-event] [:scheduled #(do (-add-event this arg)
                                                      (-run-next-tick this))]
 
@@ -159,7 +160,7 @@
             [:paused :add-event   ] [:paused   #(-add-event this arg)]
             [:paused :begin-resume] [:resuming #(-begin-resume this)]
 
-            ;; processing an event which previously caused the queue to be paused
+            ;; processing the event that caused the queue to be paused
             [:resuming :add-event    ] [:resuming  #(-add-event this arg)]
             [:resuming :exception    ] [:quiescent #(-exception this arg)]
             [:resuming :finish-resume] [:running   #(-run-queue this)]
@@ -191,7 +192,7 @@
   "
   [event-v]
   (if (nil? event-v)
-    (error "re-frame: \"dispatch\" is ignoring a nil event.") ;; nil would close the channel
+    (error "re-frame: \"dispatch\" is ignoring a nil event.")
     (enqueue event-queue event-v))
   nil)                                                      ;; Ensure nil return. See https://github.com/Day8/re-frame/wiki/Beware-Returning-False