← 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 · 30d01
Top themesdocumentation-hosting, build-infrastructure, ephemeral-builders, uvmcp, semantic-search, ai-agent, oidc
Last editorial update2h ago4h ago
WebsiteVisit →Visit →

What is Read the Docs?

Read the Docs deploys weekly, and almost all of it is rebuilding how builds run.

Read the Docs cuts a dated release every week, most of them thin — a dependency sweep, a docs correction, a CI bump. The substance in this window is concentrated in the build platform: ephemeral builders moving from experiment to implementation, uv installed and configured for generic builders, private-repo permissions plumbed through to the isolated builder, and a hardened tar extraction filter when unpacking doctools.

Read the full Read the Docs trajectory →

What is SiYuan?

SiYuan's 3.8 alpha turns the note vault into an agent surface: embeddings, reranking, MCP.

SiYuan runs a rolling alpha train in which each release restates the cumulative changelog of the one before it, so the feed reads as repetition unless you track first appearances. The 3.7.4 alphas were a long run of platform polish — Android and HarmonyOS audio recording, S Pen hover on tablets, mobile font import, sync performance, drag-and-drop cues. Then 3.8.0-alpha.1 opened a new block with three things absent from that line: OIDC authentication, an AI Agent with embedding-based semantic search and reranking, and Model Context Protocol support.

Read the full SiYuan trajectory →

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

R5.0

Read the Docs deploys weekly, and almost all of it is rebuilding how builds run.

◆ Current state

Read the Docs cuts a dated release every week, most of them thin — a dependency sweep, a docs correction, a CI bump. The substance in this window is concentrated in the build platform: ephemeral builders moving from experiment to implementation, uv installed and configured for generic builders, private-repo permissions plumbed through to the isolated builder, and a hardened tar extraction filter when unpacking doctools.

◆ Where it's heading

The through-line is the build layer being re-founded on isolation and speed. Ephemeral builders, an isolated builder that receives permissions explicitly rather than inheriting them, and uv replacing the older Python environment path all point at builds that start faster and share less. Around that, the product-facing changes are small and mostly clarifying: renaming External versions to Pull request in the interface, distinct commit statuses for skipped builds, a dropdown instead of free text when filtering redirects.

◆ Prediction

Ephemeral builders moved from a test to real wiring across these releases, so the next step is most likely rolling that path out more widely and continuing the uv migration, rather than user-facing feature work.

S
SiYuan
COLLAB
6.3

SiYuan's 3.8 alpha turns the note vault into an agent surface: embeddings, reranking, MCP.

◆ Current state

SiYuan runs a rolling alpha train in which each release restates the cumulative changelog of the one before it, so the feed reads as repetition unless you track first appearances. The 3.7.4 alphas were a long run of platform polish — Android and HarmonyOS audio recording, S Pen hover on tablets, mobile font import, sync performance, drag-and-drop cues. Then 3.8.0-alpha.1 opened a new block with three things absent from that line: OIDC authentication, an AI Agent with embedding-based semantic search and reranking, and Model Context Protocol support.

◆ Where it's heading

The 3.7.4 line was about making an existing editor pleasant on more devices; 3.8.0 is about making the vault legible to something other than a human. Semantic search over the note graph plus an MCP server positions the personal knowledge base as a context source for external agents, and OIDC landing in the same release suggests the multi-user and self-hosted deployments that make agent access worth governing. The alpha train will keep restating this block verbatim until 3.8.0 stabilizes, so the feed will understate how much has changed.

◆ Prediction

The AI Agent and MCP features will likely accumulate configuration surface across the remaining 3.8.0 alphas — model and embedding-provider choice, and scoping of which notebooks an agent may read — before a stable release.

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. 9h agoSiYuanSiYuan 3.8.0-alpha.2 restates the 3.8.0 changelog unchanged
  2. 23h agoRead the DocsPrivate repo permissions and uv setup reach the isolated builder
  3. 23h agoSiYuanSiYuan 3.8.0-alpha.1 adds an AI agent, semantic search and MCP support
  4. 3d agoSiYuanSiYuan 3.7.4-alpha.6 adds document-tab dragging into the Documents panel
  5. 4d agoSiYuanSiYuan 3.7.4-alpha.5 speeds up opening the Add to Database list
  6. 4d agoSiYuanSiYuan 3.7.4-alpha.4 adds S Pen hover for block popovers on Android tablets
  7. 6d agoSiYuanSiYuan 3.7.4-alpha.3 improves built-in Pandoc storage and upgrade compatibility
  8. 8d agoRead the DocsAutomated dependency update only
  9. 14d agoRead the DocsEphemeral builders wired up; safer doctools extraction
  10. 28d agoRead the DocsAutomation rules post commit status and stop skipping version types
  11. 1mo agoRead the DocsDocumentation link fixes
  12. 1mo agoRead the DocsFirst test of ephemeral builders; S3 sendfile header fix

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