Skip to content

docs(readme): split reference content into docs/ - #26

Merged
Alx8g merged 1 commit into
mainfrom
docs/readme-split
Sep 2, 2026
Merged

docs(readme): split reference content into docs/#26
Alx8g merged 1 commit into
mainfrom
docs/readme-split

Conversation

@Alx8g

@Alx8g Alx8g commented Sep 2, 2026

Copy link
Copy Markdown
Owner

What changed

The README shrank from 1,676 words to 602. It was carrying four documents' worth of content: Windows installer internals, the qualified Chromium 152 runtime recipe, the Linux QA checklist, and the full Wayland evidence file. All four now live in docs/, and the README covers pitch, install, features, security, hotkeys, diagnostics, build, and a documentation index.

New files

  • docs/windows-installer.md: installer layout, switches, and artwork generation, moved unchanged from the README.
  • docs/qualified-electron.md: the diagnostic Chromium 152 override, its measurements, and the Forge reproduction recipe, moved from the README.
  • docs/linux-qa-checklist.md: the six-point Linux smoke-test list, moved from the README.

Changed files

  • docs/linux-wayland.md: 2,144 words to 941. Every re-check fact, code path, and primary source survives; the quoted Chromium source dumps, issue-thread quotes, and per-section headers are gone.
  • README.md: rebuilt. The verification status of each platform now sits in the Install section where a download decision happens, the hotkey table replaced the prose list, and a documentation index links the four docs.

Unchanged on purpose

PATCHED_ELECTRON.txt and THIRD_PARTY_NOTICES.txt stay. Both are load-bearing: the first is the supply-chain provenance for the patched Electron binary, the second is GPL attribution.

Verification

  • pnpm run validate passes: lint, typecheck, 586/586 tests.
  • Nothing in src/, scripts/, tests/, or the workflows references the moved content, so no code changes were needed.

Next: your review. Nothing for you to do until then.

README drops from 1676 to 602 words. Installer internals, the qualified
Chromium 152 diagnostic runtime, the Linux QA checklist, and the Wayland
default move into docs/, so the README covers pitch, install, features,
security, hotkeys, build, and links.

linux-wayland.md keeps every re-check fact and primary source but drops
quoted Chromium source dumps (17.6k to 8.2k bytes).
@Alx8g
Alx8g merged commit 2290c64 into main Sep 2, 2026
5 checks passed
@Alx8g
Alx8g deleted the docs/readme-split branch September 2, 2026 04:31
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