From 57dc1a7be79a822554924dde3f836eed0fbfde8d Mon Sep 17 00:00:00 2001
From: Markus Schlegel <markus.schlegel@active-group.de>
Date: Mon, 10 Jun 2024 14:27:54 +0200
Subject: [PATCH] A word on why optional `empty`

---
 src/active/clojure/lens.cljc | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/src/active/clojure/lens.cljc b/src/active/clojure/lens.cljc
index 7d78c3c..56b82dc 100644
--- a/src/active/clojure/lens.cljc
+++ b/src/active/clojure/lens.cljc
@@ -463,7 +463,8 @@ right-most element where they were before."}  merge
   sequence of tuples, of a lens on the new value and lens over the
   'outer' value the lens is used on.
 
-  Example:
+  The optional `empty` will default to `nil`, so you can nil-pun your
+  way to blissful oblivion:
 ```
   (projection {(at-index 0) :a
                (at-index 1) :b})