Skip to content

Introduce the Zen of Spacetime in agent setup - #5968

Merged
cloutiertyler merged 4 commits into
masterfrom
codex/zen-agent-setup
Sep 24, 2026
Merged

cloutiertyler merged 4 commits into
masterfrom
codex/zen-agent-setup

Conversation

@cloutiertyler

@cloutiertyler cloutiertyler commented Sep 22, 2026 •

Copy link
Copy Markdown
Contributor

Description of Changes

Agents following the setup guide now encounter the Zen of Spacetime before installation, with a link to its five principles and guidance on applying them. Rename the current Zen page and its Tables-page link to “The Zen of Spacetime,” preserving the existing page URL.

Give the Zen page a light, mostly additive editorial pass: explain what persistence, subscriptions, and transactions take off the developer’s plate, and how the principles together make “everything just works” possible. Rename “Everything is Real-Time” to “Everything is Reactive” and introduce it through the analogy of extending React state to the server and database. Match the principle’s name in the agent setup summary, while retaining the real-time explanation, quotes, and code examples.

API and ABI breaking changes

None. Documentation only.

Rollback safety impact

n/a

Expected complexity level and risk

1 — Documentation wording and links only.

Testing

the original naming and agent setup changes passed a production docs build and rendered-output checks. For the editorial follow-ups, verified unchanged code blocks and links, the five-principle structure, the stable page URL, and the matching guide summary; checked the React analogy against the SDK’s useTable implementation and ran git diff --check.

The current PR head also passed the CI docs build and lints.

@JulienLavocat

Copy link
Copy Markdown
Contributor

I think you can setup a redirect from docs/docs/00100-intro/00100-getting-started/00250-zen-of-spacetimedb.md to docs/docs/00100-intro/00100-getting-started/00250-zen-of-spacetime.md (spacetimedb.md -> spacetime.md) if its desired

@cloutiertyler cloutiertyler changed the title Introduce the Zen of Spacetime in agent setup Explain the Zen of Spacetime and introduce it in agent setup Sep 22, 2026
@cloutiertyler cloutiertyler changed the title Explain the Zen of Spacetime and introduce it in agent setup Introduce the Zen of Spacetime in agent setup Sep 22, 2026
@cloutiertyler
cloutiertyler added this pull request to the merge queue Sep 24, 2026
Merged via the queue into master with commit b403766 Sep 24, 2026
44 checks passed
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.

2 participants