There are only two hard things in Computer Science: cache invalidation and naming things.

source: … famous programming joke attributed to Phil Karlton (a Netscape engineer)

[/Names]

… Our name is now layer of indirection, separating what the function does from how it does it….

Indirection, also sometimes called abstraction, is the foundation of the software we write. Layers of indirection can be peeled away incrementally, allowing to us to work within a codebase without understanding its entirety. Without indirection, we’d be unable to write software longer than a few hundred lines.

Names are not the only means of creating indirection, but they are the most common. The act of writing software is the act of naming, repeated over and over again. It’s likely that software engineers create more names than any other profession. Given this, it’s curious how little time is spent discussing names in a typical computer science education. Even in books that focus on practical software engineering, names are seldom mentioned, if at all….

[/Names/Naming data]

… Finding good names is difficult, and so wherever possible we should avoid trying. …

source: https://elementsofclojure.com/ by by Zachary Tellman

clojure.core/def

special form

Usage: (def symbol doc-string? init?)

Creates and interns a global var with the name of symbol in the current namespace (ns) or locates such a var if it already exists. If init is supplied, it is evaluated, and the root binding of the var is set to the resulting value. If init is not supplied, the root binding of the var is unaffected.

Please see https://clojure.org/reference/special_forms#def

source: https://tangrammer.codeberg.page/on-the-clojure-move/output/posts/naming-code.html

(require '[clojure.spec.alpha :as s])

(s/def ::foo string?)
;;=> ::foo

(eval ::foo)
;; => ::foo

(require '[semantic-namespace.spec.keys :as spec.keys]
  '[clojure.spec.alpha :as s])

(s/def ::id string?)
(s/def ::alias string?)

(spec.keys/def
  #{:app.api.endpoint.get/response
    :app.domain/user}
  [::id ::alias])
;;
(spec.keys/valid?
 #{:app.api.endpoint.get/response
   :app.domain/user}
 {::id "foo" ::alias "@foo"})
;;=> true

(spec.keys/valid?
 #{:app.api.endpoint.get/response
   :app.domain/user}
 {::id "foo" ::alias 55})
;;=> false


(spec.keys/valid?
 #{:app.api.endpoint.get/response
   :app.domain/user}
 {::id "foo" ::emal "foo@foo"})
;;=> false