Direct answer
Small, evidence-backed patches land faster than manifesto PRs — reproduce, minimize, explain the false positive or edge case. The same discipline applies to keeping your own projects discoverable: small, reviewable changes with a clear reason, not a rewrite.
Lessons from upstream
- Lint false positives need a minimal React/TS fixture (Biome). A fix only lands when the maintainer can see the failing case in a small, self-contained test. See biomejs/biome #11007 —
fix: recognize forwardRef named components with ref params. - Framework edges reward reproduction over rhetoric (Nitro). Three documentation PRs landed because each pinned a concrete confusion: nitrojs/nitro #4442 (
event.url.pathnamein lifecycle hooks), #4445 (route-scoped middleware path), and #4452 (minify: falsefor debugging workers). - Tooling maintainers care about blast radius (Watchexec). watchexec/watchexec #1059 —
docs: quit on Signal::Terminate— landed because it answered a real termination question, not a style nit. - Docs PRs land when they answer a real FAQ gap (ripgrep). BurntSushi/ripgrep #3491 —
docs(faq): document Windows path separators and UTF-8 locale.
A note on maintainers
The ripgrep FAQ patch was reviewed and merged by Andrew Gallant (BurntSushi), maintainer of ripgrep. A one-line docs fix only lands when the maintainer agrees the gap is real — the credit belongs to the reviewer who keeps the bar high, not to the patch author.
The same applies to the open PR rust-lang/rust-clippy #17916 (still in review): a fix for single_component_path_imports when used via crate:: / super::. Until it merges, it is evidence of effort and review, not of shipped impact.
The next phase: making independent projects discoverable
After the upstream PRs, the work moved to my own repositories. The goal was not to add features, but to make existing work findable and correctly attributed:
- BTF-Kabir-2020/wireglass — commit
5cf6607(docs: link personal project page) adds the link to https://ghourchiani.ir/projects/wireglass. Documentation only; no new capability. - BTF-Kabir-2020/cargo-rust-network-ir — commit
5cb8351(docs: link personal project page) adds the link to https://ghourchiani.ir/projects/cargo-rust-network-ir. Discoverability only. - BTF-Kabir-2020/opencode-browser-agent — commit
89da1d4(docs: link personal project page) adds the link to https://ghourchiani.ir/projects/opencode-browser-agent. Discoverability only.
A separate commit 1433236 (chore: update package homepage) changes the homepage field in package.json to the project page URL. Status check: that commit exists, but it is not on main (the branch chore/homepage-metadata-2026-10-28 is not currently visible) and the published npm package (opencode-browser-agent@2.0.4) still points to the GitHub README. It is a metadata change, not a feature or a release.
What I learned about Git hygiene
- Keep commits small and single-purpose.
docs: link personal project pagesays exactly what it does. A reviewer (or future me) can read the diff in seconds. - Separate documentation from capability. Linking a project page is not a feature; calling it one would mislead users and maintainers.
- Separate metadata from release. Changing
package.jsonhomepageis a chore, not a version bump. It should not be marketed as a release. - Review the diff before it leaves your machine.
git diff --checkand a full read ofgit diffcatch accidental files, broken paths, and half-finished edits. - One verified source per claim. Every PR and commit above is linked to a public, checkable URL.