Date: 2026-09-27
Accepted
Clornichon's design choices -- why a fork, why Cucumber's parser, why the glue is resolved early -- were scattered across the README, the CHANGELOG and commit messages. A user wondering why something works the way it does had to dig.
We record architecture decisions as Architecture Decision Records, as described by Michael Nygard: one numbered file per decision in doc/adr/, with Context, Decision and Consequences. Decisions taken before this one are recorded after the fact, dated from when they were made.
A decision that is reversed gets a new ADR that supersedes the old one; the old one stays, marked Superseded.
Can you improve this documentation?Edit on GitHub
cljdoc builds & hosts documentation for Clojure/Script libraries
| Ctrl+k | Jump to recent docs |
| ← | Move to previous article |
| → | Move to next article |
| Ctrl+/ | Jump to the search field |