Repository navigation
Conversation
…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.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
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.eulinks).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
SUMMARY.mdand the README.did:ad:, butlib/src/identifiers.rsemitsatomic:and treatsdid:ad:as the legacy spelling. Prose and examples now useatomic:(keptdid:ad:where the legacy spelling is the point).lib/src/discovery.rspublishes Iroh node IDs through the pkarr relay. Mainline DHT and Reticulum are not implemented, soidentifiers.md,sync.md,roadmap.mdandflutter.mdnow say pkarr relay + Iroh, with Reticulum marked planned.atomicserver.eu/ "Atomic Cloud" / managed-service wording is gone from the docs.ontola/atomic-server,did.mdlinks 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 inlib/src/sync/, views and templates indata-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
.mdlinks in the changed pages resolve (checked by script). No UI changes, so no screenshots.Generated by Claude Code