← Back to home
Comparison · Collab

Read the Docs vs SiYuan

A side-by-side editorial comparison of Read the Docs and SiYuan — release velocity, themes, recent moves, and the top alternatives to consider.

Read the Docs vs SiYuan: at a glance

FeatureRead the DocsSiYuan
SectorCollabCollab
Velocity score5.06.3
Sparks · 30d00
Top themesbuild-infrastructure, uv-migration, isolated-builders, schema-cleanupknowledge-management, ai-agent, mcp, cross-platform
Last editorial update31m ago2h ago
WebsiteVisit →Visit →

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 two most recent releases are the quietest of the run: plumbing for uv and build status in one, and a video extension bump, a nullable-field step toward dropping has_valid_clone, and Python 3.14 for the pip-tools workflow in the other.

Read the full Read the Docs trajectory →

What is SiYuan?

SiYuan stabilises 3.8.1 after a seven-build beta run, all of it widening the agent surface it opened in 3.8.0

SiYuan has just cut 3.8.1 stable, the endpoint of a beta chain that ran six builds in five days. The release groups into three areas: AI integration work - custom editor actions syncing across devices, an Agent panel shortcut, user-level skills read from a shared agents directory, nested rerank API formats and OpenAI Responses API support; editing and database throughput, including virtualised grouped-table rendering and faster document loading; and cross-platform reliability covering HEIF/HEIC previews, PDF export and mobile behaviour. A batch of MCP and publishing-service fixes rounds it out.

Read the full SiYuan trajectory →

Read the Docs vs SiYuan: editorial side-by-side

R5.0

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 two most recent releases are the quietest of the run: plumbing for uv and build status in one, and a video extension bump, a nullable-field step toward dropping has_valid_clone, and Python 3.14 for the pip-tools workflow in the other.

◆ 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. Alongside it runs a quieter cleanup pattern: fields are made nullable before removal, feature flags are deleted once the code behind them lands, and Python versions are pushed forward in the tooling before the runtime. 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; the has_valid_clone column being made nullable signals its removal in a following release. Feature work should stay secondary until that migration finishes.

S
SiYuan
COLLAB
6.3

SiYuan stabilises 3.8.1 after a seven-build beta run, all of it widening the agent surface it opened in 3.8.0

◆ Current state

SiYuan has just cut 3.8.1 stable, the endpoint of a beta chain that ran six builds in five days. The release groups into three areas: AI integration work - custom editor actions syncing across devices, an Agent panel shortcut, user-level skills read from a shared agents directory, nested rerank API formats and OpenAI Responses API support; editing and database throughput, including virtualised grouped-table rendering and faster document loading; and cross-platform reliability covering HEIF/HEIC previews, PDF export and mobile behaviour. A batch of MCP and publishing-service fixes rounds it out.

◆ Where it's heading

This is consolidation of the surface 3.8.0 opened, not an extension of it. The agent, semantic search and MCP endpoint arrived in the 3.8.0 line; 3.8.1 makes them portable and pluggable - skills come from a directory the user controls, editor actions follow the user between devices, and the provider layer now speaks the OpenAI Responses API rather than one bespoke shape. The high beta count against a modest final diff shows a project stabilising a young subsystem rather than building a new one.

◆ Prediction

The next line most likely pushes on the skills directory - discovery, sharing or marketplace distribution of user-level skills - since that is the piece 3.8.1 made user-editable without giving it a distribution path.

Alternatives to Read the Docs and SiYuan

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 SiYuan.

See all Read the Docs alternatives → · See all SiYuan alternatives →

Recent activity from Read the Docs and SiYuan

Latest ship moves from both products, interleaved chronologically. ⚡ = editorial spark.

  1. 20h agoRead the Docshas_valid_clone made nullable before removal; tooling bumps
  2. 1d agoSiYuanSiYuan 3.8.1 stabilises the agent, skills and Responses API work
  3. 2d agoSiYuanSlash menu items become configurable; table column widths distribute evenly
  4. 2d agoSiYuanTable headers left-align by default; double-click closes tabs
  5. 3d agoSiYuanUser-level agent skills and virtualized grouped-table rendering
  6. 3d agoSiYuanAI features move to the OpenAI Responses API
  7. 4d agoSiYuanAgent panel gains a shortcut; blockquote input fixed
  8. 7d agoRead the DocsBuild status skipped for commit-less builds; uv venv path fix
  9. 14d agoRead the DocsIsolated builders gain private-repo support and uv installs
  10. 21d agoRead the DocsDependency-only maintenance release
  11. 28d agoRead the DocsEphemeral builders land; subproject aliases accept slashes
  12. 1mo agoRead the DocsUbuntu 26.04 and Python 3.14 build images; automation fixes

Frequently asked questions

What is the difference between Read the Docs and SiYuan?

They serve adjacent needs but don't currently overlap on shipped themes. SiYuan is currently shipping more aggressively (velocity 6.3 vs 5.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 SiYuan?

Sparkpulse doesn't pick a winner — we score release velocity, not feature parity. SiYuan is currently shipping more aggressively (velocity 6.3 vs 5.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 SiYuan?

Top SiYuan alternatives in Collab are ranked by recent ship velocity. Browse the "SiYuan alternatives" section above for the current picks, or visit /alternatives/siyuan for the full list with editorial commentary on each.