Contributing to gitmanual

Thanks for helping more people get open source running. Every fixed rule fixes the manual for many repos at once.

The most useful contribution: a wrong setup

If gitmanual gave a wrong step, command or "Will it work?" answer for a repo, open a "Wrong setup" issue with:

• the repo,
• your system (and chip, if it matters),
• what gitmanual said and what actually worked, ideally with a link to where the repo's README or docs say so.

That's often all a fix needs.

Making a change

npm install
npm run dev          # http://localhost:3000
npm run typecheck
npm run build

Add a GITHUB_TOKEN to .env.local if you'll be looking up many repos (how). After a rule change, open the repos it affects: saved analyses are re-made automatically when VERSION in lib/pipeline.ts is bumped, so bump it when a change alters results.

Where things live

| To fix… | Look in | |---|---| | A stack, version or framework that isn't detected | lib/detect.ts, and lib/os.ts for how to install it on each system | | The wrong download picked from a release | lib/install.ts (classifyOs, classifyArch, KINDS) | | An install command missed, or a dependency shown as the app | lib/install.ts (METHODS, installsThisProject) | | README sections, tools or troubleshooting tips | lib/readme.ts (TOOLS, TIPS) | | "Start here": setup guides, scripts, docs links | lib/guides.ts | | "Will it work on my device?" | lib/fit.ts, and lib/platforms.ts for what READMEs say about systems | | The UI | app/, following DESIGN.md |

Rules of thumb

• A missing step beats a wrong one. Every command shown must come from the repo's own files or a well-known installer (Homebrew, winget, nvm, uv, rustup…). When unsure, point to the maintainers' guide.
• A "no" needs the project's own words. Only say a system isn't supported when the repo says so, and quote it.
• Test on real repos. In the PR, name one or two repos that show the before and after.
• Match the surrounding code style. Comments explain why, not what.

Pull requests

• One change per PR.
• npm run typecheck and npm run build pass (CI checks both).
• Be kind in reviews. See the Code of Conduct.