docs(readme): restructure + prose pass for public-repo readability - #14
Merged
anggorodewanto merged 3 commits intoJul 15, 2026
Merged
Conversation
Pure restructuring pass — every sentence survives; only headings, positions, and the intro bullets change: - Add a table of contents after the intro. - Move the M4/M5.A/M5.B/M5.C milestone paragraphs out of Quick start into a dedicated 'Feature deep-dives' section (bold leads become headings; prose verbatim). - Promote the golden flow to its own 'Try the full flow' H2 so Quick start ends at the smoke check. - Promote the admin-authorization blockquote to an 'Admin authorization' subsection under Architecture. - Rename 'Status' to 'Documentation' and move the sources-of-truth table below the visitor-facing sections (Quick start, Deploy, Game integration). - Update 'What's in the box' to match shipped scope: distribution models two -> three (ADT), plus bullets for window enforcement, auto-approve, and the admin detail-page shell + announcements, each linking to its deep-dive.
…-dives - Rewrite the em-dash-heavy telegraphic style into plain sentences (37 -> 3 em-dashes in prose); expand fragments into full sentences. - Bulletize the dense parts: the four feature deep-dives, the admin authorization block, and the golden-flow description (now a 10-step list matching the 10 NDJSON output lines). - Wrap each deep-dive body in <details>/<summary> with the heading and a one-line summary kept outside, so TOC and intro-bullet anchors still land correctly (GitHub does not auto-expand closed <details> on fragment navigation). - No facts, links, or anchors changed.
New recording: admin creates an ADT-distribution playtest with auto-approve enabled, player signs up, is approved instantly, and receives the ADT build download link. Alt text updated to match.
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
2 participants
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.
Supersedes #13 (closed; could not be reopened after a history rewrite on the branch).
Summary
Three commits preparing the README for the repo going public. No behavior, code, or doc-of-record content is touched.
1. Restructure (content-preserving)
## Feature deep-divessection.## Try the full flowsection; Quick start ends at the smoke check.### Admin authorizationsubsection under Architecture.## Statusrenamed to## Documentationand moved below the visitor-facing sections.2. Prose pass
<details>with headings and a one-line summary kept outside, so TOC/intro-bullet anchors still land correctly.3. New walkthrough GIF
Verification
#links validated against generated GitHub heading anchors (script-checked).