New Dokka - Designed for Fearless Creativity
summary
Dokka is redesigned and reimplemented from scratch to make fearless pluggability real by giving precise guarantees: type-safe plugin dependencies checked at compile time, immutable persistent models for cheap safe copying, contextless page elements, and stable DRIs for linking. Extension points like documentable→pages translators and page transformers let plugins add features — example MathJax plugin adds an embedded JS URL via a page transformer and works on the snapshot branch. Plugins install via Gradle dokkaPlugins and JVM service loader and Dokka already ships HTML, markdown outputs and full-text search.
AI-written summary · about
chapters (19)
- 0:00Intro
- 0:38Docs - it just works
- 2:21Dokka - more features?
- 5:40Solved with formatters
- 6:16Hardcoded solutions
- 7:04Solved with binary patching
- 7:40Why it is not maintainable
- 10:00The problem
- 11:45The solution
- 15:53The models
- 17:11New Dokka
- 18:57Extension Points
- 20:12Extensions
- 22:06Our extension
- 29:08Plugins - it just works?
- 30:55Plugin dependencies
- 33:33Guarantees for the rescue
- 35:31Contextlessness
- 37:11Idenifiability
related talks
42mTwo years of Markdoc: what we’ve learned about balancing developer and author experience
24mEscaping the Curse of Outdated Docs
32mAccelerating Collaborative Plugin Development
27mEnabling Developers, the Art of Keeping It Simple
37mManual documentation is dead. Long live automated documentation!
31mNavigating DocC
42mDocumentation as an application: enabling interactive content tailored to the user
29mBuilding custom Figma plugins to unlock new capabilities