Repository navigation
Docs: remove stale and historical material, keep current state only - #227
Merged
Merged
Conversation
Delete the cross-project shutdown index, the mobile-main integration receipt, the ADB quit hardening follow-on, the original Android app plan and the Logs tab design note. Their still-true facts move into v2/HANDOFF.md (quit and Logs rules, pairing, adb cwd and launcher rationale) and the mobile handoff. Rename the release decision packet to docs/DEVICE-TEST-SCRIPT.md and keep only the physical test script. Rewrite v2/HANDOFF.md, the parity table and the remote input notes in the present tense, drop shipped roadmap items, and bring CLAUDE.md's in-flight section up to date. docs/ARCHIVE-INDEX.md now lists every removed doc with the commit that last held it.
Delete the architecture review, the old screen/command matrix, the correctness audit, both feedback logs, the unknown-diagnostics UX contract, the transport licensing research, the dependency remediation receipt and the release-polish checklist and receipts. Their live facts (the no-GPL transport rule and why, saved-TV identity rules, the #105 description, open polish checks) move into HANDOFF, BACKLOG and LIFECYCLE-EVIDENCE. Rewrite HANDOFF.md as a present-tense current-state handoff and BACKLOG.md as an ordered P0/P1/P2 queue. Trim commit hashes, dated checkpoints and coordination vocabulary from the remaining plans, and correct stale claims (notices coverage, the pubkey encoder fix, the desktop rename, already-registered commands, component and CI facts).
Codex Review SummaryThis comment shows the latest Codex review activity on this pull request.
ℹ️ About Codex in GitHubYour team has set up Codex to review pull requests in this repo. Reviews are triggered when you
Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings. |
![chatgpt-codex-connector[bot]](https://avatars.githubusercontent.com/in/1144995?s=60&v=4){kind=small}
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: ff67fd16ab
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
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.
Summary
Removes stale and historical material from the repo's markdown docs. Every doc that's left now describes the project as it is, in the present tense. Dated audits, feedback logs, merge receipts and finished plans are deleted. Their still-true facts move into the live docs first. Each deleted doc gets a row in
docs/ARCHIVE-INDEX.mdwith thegit show <commit>:<path>command that recovers it; that index is the only place commit hashes remain. Out of scope:v2/CHANGELOG.md,evidence/,experiments/,v2/vendor/and the generated notices.Deleted
docs/WHERE-EVERYTHING-IS.mddocs/INTEGRATION-MOBILE-MAIN-2026-10-17.mdv2/HANDOFF.mddocs/DEVICE-LOGS-2026-10-08.mdv2/HANDOFF.mddocs/RELEASE-DECISION-2026-09-09.mddocs/DEVICE-TEST-SCRIPT.md; only the physical test script (D1–D9, A1–A10, M1–M8, staging build) is keptv2/ADB-QUIT-HARDENING.mdv2/HANDOFF.mdv2/ATV-OPTIMIZER-ANDROID-PLAN.mdv2/mobile/HANDOFF.md,BACKLOG.mdandBILLING-COMMAND-MATRIX.mdv2/mobile/ARCHITECTURE-REVIEW.mdv2/mobile/HANDOFF.md: don't reruntauri android init, and CI never builds the APKv2/mobile/FEATURES.mdv2/mobile/CORRECTNESS-AUDIT-2026-09-05.mdv2/mobile/FEEDBACK-UX-2026-09-07.mdv2/mobile/HANDOFF.md§3v2/mobile/USER-FEEDBACK-2026-09-05.mdv2/mobile/LIFECYCLE-EVIDENCE.mdv2/mobile/UNKNOWN-DIAGNOSTICS-UX.mdv2/mobile/TRANSPORT-LICENSING-RESEARCH.mdv2/mobile/HANDOFF.md§2v2/mobile/DEPENDENCY-REMEDIATION-20261016.mdcookieadvisory is now inv2/HANDOFF.mdv2/mobile/RELEASE-POLISH.mdv2/mobile/BACKLOG.mdv2/mobile/RELEASE-POLISH-RECEIPTS.mdTrimmed or rewritten
CLAUDE.md(AGENTS.mdis a symlink to it): the in-flight section now matches the actual state. 2.3.0 is the latest release; 2.3.1 is prepared onmainbut untagged, with an Unreleased section above it. Also: test-script pointer, archive-index pointer, roadmap-marker list, 16 captured screens. The signing and update-key section is unchanged.v2/HANDOFF.md: rewritten. The table of closed issues is replaced by the rationale each fix left behind.docs/ARCHIVE-INDEX.md: new "Docs removed from the repository" table.docs/FEATURES.md: scoped as the v1 catalog. Dropped the obsolete "spec for the v2 rewrite" rules and corrected the claim that v2 fetches app lists at runtime.v2/ATVTOOLS-PARITY.md: the shipped roadmap is replaced by the remaining gaps (screen recording, mouse mode).v2/REMOTE-LATENCY-PLAN.md: now a reference for how the scrcpy channel works. It keeps the hardware measurements and lifecycle rules and drops the phases, estimates and IPs.v2/README.md,v2/screenshots/README.md,v2/src/fonts/README.md: small factual fixes.v2/mobile/HANDOFF.md: rewritten as a present-tense handoff, about 490 lines down to 245.v2/mobile/BACKLOG.md: rewritten as P0/P1/P2.v2/mobile/README.md,RELEASE.md,LIFECYCLE-EVIDENCE.md,PAIRING-PLAN.md,FAST-REMOTE-PLAN.md, the billing and free-undo docs,EXPORT-DISCOVERABILITY.md,ANDROID-DEPENDENCIES.md,v2/tools/emulator/README.md: removed hashes, receipts and dated narration.Kept on purpose, though they were candidates for deletion:
LIFECYCLE-EVIDENCE.md(#105 is open),PAIRING-PLAN.md(pairing hasn't been verified on a device),FAST-REMOTE-PLAN.md(Phase 4 is open),EXPORT-DISCOVERABILITY.md(SAF export is pending), and the billing and free-undo plans (not built).docs/FEATURES.mdstays because v2 code comments cite its section numbers.Evidence
Docs only, nothing visual, so no screenshots or video. Tested at the head of this branch:
PAIRING-PLAN.md.git showtarget indocs/ARCHIVE-INDEX.mdresolves.git grepfor each deleted filename finds nothing outsidedocs/ARCHIVE-INDEX.mdandevidence/.🤖 Generated with Claude Code