Explanations are value laden: build fix and spelling errors (#185)

This commit removes the previously added link system due to errors I
can't explain. Get the content out!

Author: teodorlu

src/civitas/why/explanations_are_value_laden.clj

@@ -1,77 +1,38 @@
 ^{:kindly/hide-code true
-  :clay {:title "Explanations are value laden" :quarto {:author :com.github/teodorlu :type :post :date "2025-11-15"}}}
+  :clay {:title "Explanations are value laden" :quarto {:author :com.github/teodorlu :type :post :date "2025-11-16"}}}
 (ns civitas.why.explanations-are-value-laden
-  (:require [civitas.why.growing-explanations-together :as-alias growing-explanations-together]
-            [civitas.why.village.scene :as-alias search-for-meaning]
-            [clojure.string :as str]
-            [scicloj.kindly.v4.kind :as kind]))
-
-::search-for-meaning/anchor
-::growing-explanations-together/anchor
-
-^:kindly/hide-code
-(defonce link-root "")
-
-^:kindly/hide-code
-(defn infer-html-location [anchor]
-  ;; I found this way of doing "checked" links surprisingly pleasant.
-  ;; Funnily enough, the *name* of the anchor (which we currently ignore) could (possibly) turn into a hash-link, eg "/civitas/.../scene#process" for ::search-for-meaning/process
-  ;; But let's not be distracted by shiny, new ways of linking knowledge right now.
-  ;;
-  ;; Second problem: while this link works in production, Clay doesn't care about those URLs.
-  ;; So we'll just redef the def from our REPL while writing this text.
-  (str link-root
-       (str/join
-        "/"
-        (->> (str/split (namespace anchor) #"\.")
-             (map #(str/replace % #"-" "_"))))
-       ".html"))
+  (:require [scicloj.kindly.v4.kind :as kind]))
 
 ^:kindly/hide-code
 (comment
-  ;; "test".
-  (def link-root "https://clojurecivitas.github.io/")
-  (infer-html-location ::search-for-meaning/anchor)
-
-  (require '[clojure.java.browse :refer [browse-url]])
-  (mapv (comp browse-url infer-html-location)
-        [::search-for-meaning/anchor ::growing-explanations-together/anchor])
-
+  ;; This post previously included a light system for linking between documents.
+  ;; However, that system unfortunately crashed the build process!
+  ;; So I had to remove it.
+  ;; See the PR for the removed code: https://github.com/ClojureCivitas/clojurecivitas.github.io/pull/185
   )
 
 ^:kindly/hide-code
-(defn link [anchor linktext]
-  [:a {:href (infer-html-location anchor)} linktext])
-
-;; # Explanations are value laden
-
-^:kindly/hide-code
-(kind/hiccup [:p "Timothy Pratley recently wrote about "
-              (link ::search-for-meaning/anchor
-                    [:span "the pursuit of " [:em "meaning"]])
-              " on civitas."
-              " Before that; I argued that "
-              (link ::growing-explanations-together/anchor
-                    "Civitas is a great place to grow explanations together")
-              "."
-              ])
+(kind/hiccup
+ [:p "Timothy Pratley recently wrote about " [:a {:href "/civitas/why/village/scene.html"} "the pursuit of meaning on Civitas."]
+  " Before that; I argued that "
+  [:a {:href "/civitas/why/growing_explanations_together.html"} "Civitas is a great place to grow explanations together"] "."])
 
 ;; These two messages are connected.
 ;; Today, I explore how.
 ;;
-;; What is whorthwile to explain? Anything? No.
+;; What is worthwhile to explain? Anything? No.
 ;;
 ;; I can explain the number of grains of sand on a beach.
-;; That explanation is *not interesting* compared to what I *could* be explaning.
-;; I would rather explain how numbers with units help you gain clarity.
+;; That explanation is *not interesting* compared to what I *could* be explaining.
+;; I would rather explain how numbers with units of measure helps you write clearer code.
 ;; How you can use a drop of science to spice up your world of software development.
 ;; How a sliver of programming can help you move the world as a designer.
 ;;
 ;; I feel zero need to explain how to “nudge” people into making decisions they do not want to make.
 ;; I feel zero need to add more mess, chaos, advertisement and coercion into an already confusing and coercive world.
 ;; Why am I bombarded with messaging to change my behavior every place I see?
 ;; Why does this happen even when I use services I pay for?
-;; I dispise this trend.
+;; I despise this trend.
 ;;
 ;; So what?
 ;; Then what?