AFFiNE
A nightly canary train where the AI platform work hides between dependency bumps
Comparison · Collab
Read the Docs vs tufte
A side-by-side editorial comparison of Read the Docs and tufte — release velocity, themes, recent moves, and the top alternatives to consider.
Read the Docs vs tufte: at a glance
What is Read the Docs?
Read the Docs is rebuilding its build farm around uv and isolated builders, one week at a time.
Weekly date-tagged releases, almost entirely build infrastructure. The visible work is a migration to uv-managed environments and isolated, ephemeral builders, shipped in small increments between routine dependency bumps. The most recent release is plumbing: skip build status when there is no commit, pin pip back, and point uv at the interpreter inside the venv.
What is tufte?
After three quiet years, tufte 0.15 finally lets Tufte-style documents cross-reference.
Almost every release before the latest is a Pandoc compatibility fix — sidenotes breaking on Pandoc 2.15, margin references misplaced on 2.11, table and citation handling in `tufte_handout()`, `--wrap preserve` for margin content on 2.19. Then 0.15.0 in May 2026 breaks the pattern: `tufte_handout2()`, `tufte_book2()` and `tufte_html2()` wrap the corresponding bookdown formats, enabling text references and cross-references in captions, and `margin_fig_pos` gives global control over margin-figure placement.
Read the Docs vs tufte: editorial side-by-side
Read the Docs
5.0COLLAB
Read the Docs is rebuilding its build farm around uv and isolated builders, one week at a time.
◆ Current state
Weekly date-tagged releases, almost entirely build infrastructure. The visible work is a migration to uv-managed environments and isolated, ephemeral builders, shipped in small increments between routine dependency bumps. The most recent release is plumbing: skip build status when there is no commit, pin pip back, and point uv at the interpreter inside the venv.
◆ Where it's heading
The isolated builder is the arc worth tracking — private repository support, an ephemeral builder script, and removal of the old scale-in protection path all point at builds that run in disposable environments. User-facing change is rare and arrives as a side effect, as when July's release moved images to Ubuntu 26.04 and Python 3.14.
◆ Prediction
Expect the isolated builder to become the default path and further uv environment fixes; feature work should stay secondary until that migration finishes.
tufte
0.0COLLAB
After three quiet years, tufte 0.15 finally lets Tufte-style documents cross-reference.
◆ Current state
Almost every release before the latest is a Pandoc compatibility fix — sidenotes breaking on Pandoc 2.15, margin references misplaced on 2.11, table and citation handling in `tufte_handout()`, `--wrap preserve` for margin content on 2.19. Then 0.15.0 in May 2026 breaks the pattern: `tufte_handout2()`, `tufte_book2()` and `tufte_html2()` wrap the corresponding bookdown formats, enabling text references and cross-references in captions, and `margin_fig_pos` gives global control over margin-figure placement.
◆ Where it's heading
The package spent years absorbing upstream Pandoc churn without adding anything, and has now moved to sit on top of bookdown rather than reimplement around it. That is the sustainable direction for a format package this small: inherit cross-referencing and text references instead of maintaining a parallel implementation. Release intervals remain long, so this is unlikely to become a fast-moving package.
◆ Prediction
Expect the bookdown-backed formats to absorb further fixes as the recommended path, with the plain `tufte_*()` formats staying frozen against Pandoc changes.
Alternatives to Read the Docs and tufte
Other Collab products tracked by Sparkpulse, ranked by recent ship velocity. Each card links to a full editorial trajectory and lets you pivot into a head-to-head comparison with either Read the Docs or tufte.
pagedown
pagedown is down to one small fix a year, mostly absorbing changes from elsewhere.
xaringan
xaringan has settled into theme upkeep and Pandoc-era compatibility patches.
Double
Double is turning its accounting assistant into the way the work gets done
litedown
litedown grows from a lean renderer into a book and site generator
bookdown
bookdown's output is mature; its free hosting destination is being switched off.
See all Read the Docs alternatives → · See all tufte alternatives →
Recent activity from Read the Docs and tufte
Latest ship moves from both products, interleaved chronologically. ⚡ = editorial spark.
- 2d agoRead the DocsBuild status skipped for commit-less builds; uv venv path fix
- 9d agoRead the DocsIsolated builders gain private-repo support and uv installs
- 16d agoRead the DocsDependency-only maintenance release
- 23d agoRead the DocsEphemeral builders land; subproject aliases accept slashes
- 1mo agoRead the DocsUbuntu 26.04 and Python 3.14 build images; automation fixes
- 1mo agoRead the DocsDocumentation link fixes
- 2mo agotuftetufte 0.15.0
- 3y agotuftetufte 0.13 fixes margin content on Pandoc 2.19
- 4y agotuftetufte 0.12 restores sidenotes on Pandoc 2.15
- 4y agotuftetufte 0.11 fixes tables and citations in handouts
- 5y agotuftetufte 0.10 fixes margin references with link-citations
- 5y agotuftetufte 0.9 adds CSLReferences for Pandoc 2.11 citeproc
Frequently asked questions
What is the difference between Read the Docs and tufte?
They serve adjacent needs but don't currently overlap on shipped themes. Read the Docs is currently shipping more aggressively (velocity 5.0 vs 0.0), with 0 editorial sparks in the last 30 days against 0. See the at-a-glance table above for a side-by-side breakdown of velocity, recent sparks, and editorial themes.
Is Read the Docs better than tufte?
Sparkpulse doesn't pick a winner — we score release velocity, not feature parity. Read the Docs is currently shipping more aggressively (velocity 5.0 vs 0.0), with 0 editorial sparks in the last 30 days against 0. For your specific use case, the alternatives sections above list other Collab products to evaluate alongside.
What are the best alternatives to Read the Docs?
Top Read the Docs alternatives in Collab are ranked by recent ship velocity. Browse the "Read the Docs alternatives" section above for the current picks, or visit /alternatives/read-the-docs for the full list with editorial commentary on each.
What are the best alternatives to tufte?
Top tufte alternatives in Collab are ranked by recent ship velocity. Browse the "tufte alternatives" section above for the current picks, or visit /alternatives/tufte-r for the full list with editorial commentary on each.