Conversation
zsumz
requested a deployment
to
architecture-policy-review
September 9, 2026 15:55 — with
GitHub Actions
Waiting
zsumz
requested a deployment
to
architecture-policy-review
September 9, 2026 16:11 — with
GitHub Actions
Waiting
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.
Explain how to build with Rafter's optional crates and which responsibilities belong to the application. The README describes the available layers while preserving its original header, description, and navigation links.
The getting-started guide follows six integration decisions: choose a starting layer, implement application behavior, connect durable storage and recovery, configure TLS peers, submit requests through the service, and drive the server loop. Short excerpts from one standalone counter explain the actual public APIs and distinguish Rafter's types from application helpers. A write walkthrough follows one increment through the stack, then shows how to adapt the counter or replace individual components.
The complete counter runs three separate server processes with disk-backed state and mutually authenticated TLS. Setup commands and the expandable full-source reference come after the teaching sections. The guide explains application state versus Raft storage, saved applied progress, request outcomes, client versus peer traffic, and the remaining deployment choices. The starter keeps fixed membership and its full log; HTTP binds only to loopback.
Validation:
python3 scripts/check-counter-guidechecks all 11 teaching excerpts against the standalone source, extracts the complete source reference into a fresh project outside the repository, and passes Rust 1.88 formatting, Clippy with warnings denied, unit tests, build, and the real-process smoke test. CI runs this check.git diff --cached --checkpasses.