From 9c66a26cd48b8d68d65f59e66f7082871da66a7a Mon Sep 17 00:00:00 2001
From: Noah Bogart <noah.bogart@hey.com>
Date: Thu, 21 Nov 2024 09:42:27 -0500
Subject: [PATCH] Clean up some doc comments

---
 src/clojure/lazytest/core.clj | 24 +++++++++++-------------
 1 file changed, 11 insertions(+), 13 deletions(-)

diff --git a/src/clojure/lazytest/core.clj b/src/clojure/lazytest/core.clj
index d14a170..299b1d8 100644
--- a/src/clojure/lazytest/core.clj
+++ b/src/clojure/lazytest/core.clj
@@ -63,8 +63,7 @@
 ;;; Public API
 
 (defmacro ->ex-failed
-  "Useful for all expectations. Sets the base
-  properties on the ExpectationFailed."
+  "Useful for all expectations. Sets the base properties on the ExpectationFailed."
   {:arglists '([expr data]
                [&form expr {:keys [message evaluated actual]}])}
   ([expr data] `(->ex-failed nil ~expr ~data))
@@ -175,14 +174,13 @@
        {:after after-fn#})))
 
 (defmacro around
-  "Builds a function for the `around` context.
-
-  Usage:
-  (describe some-func
-    {:context [(around [f]
-                 (binding [*foo* 100]
-                   (f)))]}
-    ...)"
+  "Builds a function for the `around` context. Works like an anonymous function:
+
+  ```clojure
+  (around [f]
+    (binding [*foo* 100]
+      (f)))
+  ```"
   [param & body]
   (assert (and (vector? param)
                (= 1 (count param))
@@ -196,9 +194,9 @@
 (defn set-ns-context!
   "Add hooks to the namespace suite, instead of to a var or test suite.
 
-  `context` must be a sequence of context maps."
-  [context]
-  (alter-meta! *ns* assoc :context (ctx/merge-context context)))
+  `contexts` is a sequence of context maps."
+  [contexts]
+  (alter-meta! *ns* assoc :context (ctx/merge-context contexts)))
 
 (def ^:dynamic *context* nil)