Summary
The "Contributing from source" section in README.md lists a "short path" of tools to install before building (Git, Node.js 24+, pnpm 10.10.0, Rust 1.93.0 (rustfmt + clippy), CMake, …). That list is now stale relative to CONTRIBUTING.md's expanded prerequisites table — it's missing Ninja and ripgrep, both of which a fresh contributor will hit during their first build / first git push.
Problem / Context
A contributor who reads only the README's "Contributing from source" summary (which is intentionally short and points at CONTRIBUTING.md for the long version) will still install the wrong set of tools and hit the same two failures we filed PRs #1783 / #1867 to document.
Acceptance criteria
Out of scope
- Adding macOS-specific platform notes (x86_64 target, codesign script) inline in the README — those are correctly delegated to
CONTRIBUTING.md via the existing "platform desktop build prerequisites" phrase and the link at the top of the section.
- Re-organizing the README's broader structure — this is a one-line list fix.
Summary
The "Contributing from source" section in
README.mdlists a "short path" of tools to install before building (Git, Node.js 24+, pnpm 10.10.0, Rust 1.93.0 (rustfmt + clippy), CMake, …). That list is now stale relative toCONTRIBUTING.md's expanded prerequisites table — it's missing Ninja and ripgrep, both of which a fresh contributor will hit during their first build / firstgit push.Problem / Context
CONTRIBUTING.md's prerequisites in docs(CONTRIBUTING): add missing macOS prereqs (Ninja, x86_64 target, … #1783 (required on macOS to build the bundled CEF helper — without itcef-dll-sys's build script aborts). The README still doesn't mention it.CONTRIBUTING.mdin fix(lint): make commands-tokens script fail with a clear error when ripgrep is missing + add to CONTRIBUTING prereqs #1867 (required by thelint:commands-tokenspre-push step inapp/package.json). The README doesn't mention it either.A contributor who reads only the README's "Contributing from source" summary (which is intentionally short and points at
CONTRIBUTING.mdfor the long version) will still install the wrong set of tools and hit the same two failures we filed PRs #1783 / #1867 to document.Acceptance criteria
README.md"Contributing from source" bullet 1 includesNinjaandripgrepalongside the existing tool list.Out of scope
CONTRIBUTING.mdvia the existing "platform desktop build prerequisites" phrase and the link at the top of the section.