cljdoc
summary
cljdoc provides hosted, versioned API and article docs for Clojure and ClojureScript libraries, automatically building docs when a release appears on Clojars via automated CircleCI builds that produce artifacts and error badges; it renders Markdown and AsciiDoc, supports namespace/platform differences (Clojure vs ClojureScript), and exports zips usable by Dash. The system is ~5k lines of code, stores metadata in SQLite, uses Integrant/Hiccup and Terraform/Nomad for ops, and is production‑used by projects like rum and nrepl with live, per‑release links and versioned documentation per release.
AI-written summary · about
chapters (10)
- 0:00Introduction to cljdoc
- 1:47What cljdoc offers you
- 8:08Documentation features demo
- 12:17Versioning and downloads
- 14:42Integration with Dash
- 17:30Why cljdoc exists
- 22:29How cljdoc works
- 26:43How you can help
- 30:57Future improvements
- 34:48Thanks and Q&A
related talks
55mTransforming Enterprise Development With Clojure
24mEscaping the Curse of Outdated Docs
38mProduction Ready ClojureScript: Tales from the Frontier
44mPushing documentation (so it doesn't hurt anymore)
33mA Tale of ClojureScript in Production
35mLightning Talks
42mEngineering Documentation
27mBuilding functional Front-ends with ClojureScript