Skip to content

Docs: advertise Personal Data Store, All-in-One Workspace and Local-first Sync Engine - #2109

Closed
joepio wants to merge 1 commit into
developfrom
claude/project-thread-rmig46
Closed

joepio wants to merge 1 commit into
developfrom
claude/project-thread-rmig46

Conversation

@joepio

@joepio joepio commented Oct 6, 2026

Copy link
Copy Markdown
Member

Requested by Joep · project thread

Before: the docs opened on the Atomic Data specification and the AtomicServer feature list. Nothing said what the product is for, and several pages contradicted the code (did:ad: as the canonical identifier, discovery over Mainline DHT, an 8MB binary, atomicserver.eu links).

After: a new "Why Atomic" section opens the book with one page for each proposition, and the README leads with the same three. The stale claims are fixed.

What changed

  • New pages: Why Atomic, Personal Data Store, All-in-One Workspace, Local-first Sync Engine; linked from the overview, the AtomicServer chapter, SUMMARY.md and the README.
  • Identifiers: pages said did:ad:, but lib/src/identifiers.rs emits atomic: and treats did:ad: as the legacy spelling. Prose and examples now use atomic: (kept did:ad: where the legacy spelling is the point).
  • Discovery: lib/src/discovery.rs publishes Iroh node IDs through the pkarr relay. Mainline DHT and Reticulum are not implemented, so identifiers.md, sync.md, roadmap.md and flutter.md now say pkarr relay + Iroh, with Reticulum marked planned.
  • Brand and scope: "atomic.place" everywhere, and the atomicserver.eu / "Atomic Cloud" / managed-service wording is gone from the docs.
  • Smaller fixes: 8MB binary is ~70MB, repo links point at ontola/atomic-server, did.md links no longer go to the stub.

How
Every claim on the new pages was checked against the code (encryption key wrapping in localDbKey.ts, transports in lib/src/sync/, views and templates in data-browser). The earlier docs PRs were #1552 (local-first story, merged), #1572 (feature list, merged) and #1253 (older refresh, closed as stale); this builds on the first two. I did not bring over #1253's separate presence, CMS and tables pages, because the tables and AI pages already exist on develop; they can follow.

No mdBook in this environment, so the build was not run; all internal .md links in the changed pages resolve (checked by script). No UI changes, so no screenshots.


Generated by Claude Code

…irst Sync Engine; fix stale identifier and discovery claims

New Why Atomic section with one page per proposition. Identifiers are
written as atomic: (did:ad: is the accepted legacy spelling), peer
discovery is described as the pkarr relay plus Iroh (Mainline DHT and
Reticulum are not implemented), saas-specific links and the 8MB binary
size are corrected, and repo links point at ontola/atomic-server.
@joepio joepio self-assigned this Oct 6, 2026
joepio added a commit that referenced this pull request Oct 6, 2026
One tested commit: Cloud Server first uploads and hosting status races (#2108), a multi-day event keeps its end date and JSON filters match by value (#2112), and docs for Personal Data Store, All-in-One Workspace and Local-first Sync Engine (#2109).

Co-authored-by: Joep Meindertsma <joep@ontola.io>
@joepio joepio closed this Oct 6, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant