diff --git a/resources/signal-docstrings/signal-creators.txt b/resources/signal-docstrings/signal-creators.txt
index cc046d6..488ca2a 100644
--- a/resources/signal-docstrings/signal-creators.txt
+++ b/resources/signal-docstrings/signal-creators.txt
@@ -14,13 +14,13 @@ various keys:
 Creators vary only in in their default options and call APIs (expected args
 and return values), making them more/less convenient for certain use cases:
 
-  `log!` ---------- [message + opts/level] => true iff signal was created (allowed)
-  `event!` -------- [id      + opts/level] => true iff signal was created (allowed)
-  `error!` -------- [error   + opts/id   ] => given error (unconditional)
-  `trace!` -------- [form    + opts/id   ] => form result (value/throw) (unconditional)
-  `spy!` ---------- [form    + opts/level] => form result (value/throw) (unconditional)
-  `catch->error!` - [error   + opts/id   ] => form value, or given fallback
-  `signal!` ------- [          opts      ] => depends on options
+  `event!` -------- [id   ] or [id   opts/level] => true iff signal was created (allowed)
+  `log!` ---------- [msg  ] or [opts/level  msg] => true iff signal was created (allowed)
+  `error!` -------- [error] or [opts/id   error] => given error (unconditional)
+  `trace!` -------- [form ] or [opts/id    form] => form result (value/throw) (unconditional)
+  `spy!` ---------- [form ] or [opts/level form] => form result (value/throw) (unconditional)
+  `catch->error!` - [form ] or [opts/id    form] => form value, or given fallback
+  `signal!` ------- [opts ]                      => depends on options
 
 - `log!` and `event!` are both good default/general-purpose signal creators.
 - `log!` emphasizes messages, while `event!` emphasizes ids.
diff --git a/src/taoensso/telemere.cljc b/src/taoensso/telemere.cljc
index f83e9d1..4553d05 100644
--- a/src/taoensso/telemere.cljc
+++ b/src/taoensso/telemere.cljc
@@ -82,14 +82,14 @@
   (impl/defhelp help:environmental-config :environmental-config))
 
 ;;;; Signal creators
-;; - signal!                  [              opts] ;                 => allowed? / run result (value or throw)
-;; - event!           [id   ] [id   level-or-opts] ; id     + ?level => allowed? ; Sole signal with descending main arg!
-;; - log!             [msg  ] [level-or-opts  msg] ; msg    + ?level => allowed?
-;; - error!           [error] [id-or-opts   error] ; error  + ?id    => given error
-;; - trace!           [form ] [id-or-opts    form] ; run    + ?id    => run result (value or throw)
-;; - spy!             [form ] [level-or-opts form] ; run    + ?level => run result (value or throw)
-;; - catch->error!    [form ] [id-or-opts    form] ; run    + ?id    => run value or ?return
-;; - uncaught->error! [     ] [id-or-opts        ] ;          ?id    => nil
+;; - event!           [id   ] [id   opts/level] ; id     + ?level => allowed? ; Sole signal with descending main arg!
+;; - log!             [msg  ] [opts/level  msg] ; msg    + ?level => allowed?
+;; - error!           [error] [opts/id   error] ; error  + ?id    => given error
+;; - trace!           [form ] [opts/id    form] ; run    + ?id    => run result (value or throw)
+;; - spy!             [form ] [opts/level form] ; run    + ?level => run result (value or throw)
+;; - catch->error!    [form ] [opts/id    form] ; run    + ?id    => run value or ?return
+;; - signal!          [opts ]                   ;                 => allowed? / run result (value or throw)
+;; - uncaught->error! [opts/id]                 ;          ?id    => nil
 
 #?(:clj
    (defmacro event!