From f2a52886fb6f731e1fb9da8e9c4421e8144b704d Mon Sep 17 00:00:00 2001 From: PEZ Date: Wed, 1 Oct 2025 08:12:44 +0200 Subject: [PATCH] Removes duplicated docstring placement instruction --- instructions/clojure.instructions.md | 14 -------------- 1 file changed, 14 deletions(-) diff --git a/instructions/clojure.instructions.md b/instructions/clojure.instructions.md index e3de5c5..f9d7bb4 100644 --- a/instructions/clojure.instructions.md +++ b/instructions/clojure.instructions.md @@ -189,21 +189,7 @@ Rich Comment Forms `(comment ...)` serve a different purpose than direct REPL ev - **Exploration preservation** - Keep useful REPL discoveries in the codebase - **Example scenarios** - Demonstrate edge cases and typical usage -### Docstrings in `defn` -Docstrings belong immediately after the function name and before the argument vector. - -```clojure -(defn my-function - "This function does something." - [arg1 arg2] - ;; function body - ) -``` - -- Define functions before they are used—prefer ordering over `declare` except when truly necessary. - ### RCF Patterns - RCF = Rich Comment Forms. When files are loaded code in RCFs is not evaluated, making them perfect for documenting example usage, since humans easily can evaluate the code in there at will.