Clojurians Log v2

I feel like The Pragmatic Programmer also talks about this, at least in spirit (it's been a long time since I read it).

subscribing to the thread! I don't remember seeing it phrased like this, but I can think of a few practices that fall into this category. Something that's underappreciated is basically adding your own identifiers as anchors in comments, especially when you have code in multiple places that should be considered together

;; this looks terrible but was done for good reasons, see NOODLEHACK26

... somewhere else ...

;; Keep in sync with noodle definitions based on flux capacitor spec, see NOODLEHACK26

Tangentially related to what Arne wrote, a new habit I took up recently was to move comments inside the forms they annotate. Sort of like docstrings for forms that don't support docstrings. This way they have a better chance of moving together.

(;; we need to do this to align the index with the COBOL system
 inc foo)

@imre I do the exact same thing! Too bad nobody reads the comments, regardless of whether they're in or out of the form 😛

My comments aren't for others. They are for myself in 2 years 😛

ah, you're "nobody" then 🙂

And I want them to travel with the code as others move things around in those 2 years

"we are the noooobodies. we want to be soooomebodies" 🎶

Same. Clojure code is awesome in terms of just moving things around. Might as well work with that feature.

I often move stuff around without running it and I still have faith that it'll work because it's just so predictable and stable.