Skip to content

docs: rewrite README around the real git-like workflow - #22

Merged
SammyBytes merged 1 commit into
mainfrom
docs/readme-refresh
Aug 29, 2026
Merged

docs: rewrite README around the real git-like workflow#22
SammyBytes merged 1 commit into
mainfrom
docs/readme-refresh

Conversation

@SammyBytes

Copy link
Copy Markdown
Owner

Summary

The README described the pre-5.9 world (push/pull as gRPC file streaming) and called binary-manager/mysql-embedded "future placeholders" even though they shipped. Rewritten to be practical and accurate.

Changes

  • Install (binary/container) + how the Dolt binary self-installs.
  • Quick start: clone/init → start → commit → push → pull.
  • Command tables grouped by setup/auth, local workflow, server/versioning.
  • "How syncing works" (commit-based push/pull, permissions, TLS) + the transitional gRPC-flag note.
  • Configuration table, corrected architecture (real contexts), development, security.

Every documented command matches deltix help output. Docs only — no code.

The old README described the pre-5.9 world (push/pull as gRPC file streaming)
and called binary-manager/mysql-embedded 'future placeholders' even though
they shipped. Rewritten to be practical and accurate:
- Install (binary/container) + how the Dolt binary self-installs.
- Quick start: clone/init -> start -> commit -> push -> pull.
- Command tables grouped by setup/auth, local workflow, server/versioning.
- 'How syncing works' (commit-based push/pull, permissions, TLS) + the
  transitional gRPC flag note.
- Configuration table, architecture (correct contexts), development, security.
@SammyBytes
SammyBytes merged commit 6fa27b7 into main Aug 29, 2026
2 checks passed
@SammyBytes
SammyBytes deleted the docs/readme-refresh branch August 29, 2026 21:37
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