← Back to home
Comparison · Collab

Read the Docs vs Shiori

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

Read the Docs vs Shiori: at a glance

FeatureRead the DocsShiori
SectorCollabCollab
Velocity score5.00.0
Sparks · 30d00
Top themesdocumentation-hosting, build-tooling, github-app, direct-uploadbookmarks, self-hosted, api-first, golang
Last editorial update10h ago3mo ago
WebsiteVisit →Visit →

What is Read the Docs?

Read the Docs moves builds to Python 3.14 and Ubuntu 26.04 by default.

Read the Docs ships a dated release most weeks. October's notable changes: the default build image moved to Python 3.14 and Ubuntu 26.04, git:// URLs are no longer allowed, search scores pages by their best-matching section, and certifi was upgraded to distrust the compromised eMudhra CAs. Earlier October work added temporary environment variables in build commands, a size cap on build media, and the GitHub App as the default on Community.

Read the full Read the Docs trajectory →

What is Shiori?

A Go bookmark manager rebuilding itself around an API — and only ever shipping release candidates.

Shiori is a self-hosted read-later and bookmark tool whose recent history is entirely release candidates: v1.7.0-rc.2, rc.3, v1.7.2-rc.1, v1.8.0-rc.1. The visible work has moved off the web UI and into an API v1 surface — tag endpoints, bookmark-tag association, filtering and counts — plus infrastructure like proxy-header authentication and SQLite performance. The last tagged release in this window is from July 2025.

Read the full Shiori trajectory →

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

R5.0

Read the Docs moves builds to Python 3.14 and Ubuntu 26.04 by default.

◆ Current state

Read the Docs ships a dated release most weeks. October's notable changes: the default build image moved to Python 3.14 and Ubuntu 26.04, git:// URLs are no longer allowed, search scores pages by their best-matching section, and certifi was upgraded to distrust the compromised eMudhra CAs. Earlier October work added temporary environment variables in build commands, a size cap on build media, and the GitHub App as the default on Community.

◆ Where it's heading

Two threads run through the releases: a direct upload path for docs built elsewhere, which has had design docs, workflows and onboarding in September and October, and steady hardening of the build platform. Most entries are still lists of merged PRs with dependency bumps.

◆ Prediction

Expect direct upload to move toward general availability and more GitHub App defaults replacing the OAuth app.

S
Shiori
COLLAB
0.0

A Go bookmark manager rebuilding itself around an API — and only ever shipping release candidates.

◆ Current state

Shiori is a self-hosted read-later and bookmark tool whose recent history is entirely release candidates: v1.7.0-rc.2, rc.3, v1.7.2-rc.1, v1.8.0-rc.1. The visible work has moved off the web UI and into an API v1 surface — tag endpoints, bookmark-tag association, filtering and counts — plus infrastructure like proxy-header authentication and SQLite performance. The last tagged release in this window is from July 2025.

◆ Where it's heading

The project is converting from a web app with an API bolted on into an API-first service with a client, and the login component, PWA and theme work are being rewritten around that split. Proxy forward-header authentication in particular is a deployment-shape decision: it assumes Shiori sits behind an authenticating reverse proxy rather than owning identity itself. The RC-only tagging pattern makes it hard to tell what the maintainers consider stable.

◆ Prediction

The next step is presumably a final v1.8.0 consolidating the API v1 tag work, though nothing in these entries indicates the RC-to-stable promotion is scheduled. If the pattern holds, the following RC continues on API endpoints rather than the UI.

Alternatives to Read the Docs and Shiori

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

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

Recent activity from Read the Docs and Shiori

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

  1. 6d agoRead the DocsRedirect form tweaks and slug-change notices
  2. 12d agoRead the DocsDefaults move to Python 3.14 and Ubuntu 26.04
  3. 20d agoRead the DocsNo commit status on closed PR previews
  4. 20d agoRead the DocsRelease branch merge, no listed changes
  5. 20d agoRead the DocsRelease branch merge, no listed changes
  6. 27d agoRead the DocsTemporary build env vars and the GitHub App by default
  7. 1y agoShioriAPI v1 gains tag endpoints, filtering and counts; proxy header auth
  8. 1y agoShioriSwagger UI disabled by default; session auth and Postgres fixes
  9. 2y agoShioriLight, dark and system theme selection in the web UI
  10. 2y agoShioriHome button clears the active search query

Frequently asked questions

What is the difference between Read the Docs and Shiori?

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 Shiori?

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 Shiori?

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