---
title: "یادداشت مشارکت upstream: Biome، Nitro، Watchexec، ripgrep"
description: "درس‌هایی از PRهای merged در Biome، Nitro، Watchexec و ripgrep، و از قابل‌کشف‌کردن پروژه‌های مستقل — تغییرات کوچک و قابل‌بررسی، نه دمو."
author: "Mohammad Pouya Ghourchiani"
canonical: "https://ghourchiani.ir/fa/blog/upstream-contribution-diary"
image: "https://ghourchiani.ir/og/mark-square.png"
date: "2026-09-17"
updated: "2026-10-28"
lang: "fa"
generated: "2026-11-19"
---
# یادداشت مشارکت upstream: Biome، Nitro، Watchexec، ripgrep

> **خلاصه:** درس‌هایی از PRهای merged در Biome، Nitro، Watchexec و ripgrep، و از قابل‌کشف‌کردن پروژه‌های مستقل — تغییرات کوچک و قابل‌بررسی، نه دمو.

## پاسخ مستقیم

تغییر کوچک با شاهد سریع‌تر از PR مانیفست merge می‌شود — reproduce کن، کوچک کن، false positive یا edge case را توضیح بده. همین نظم در قابل‌کشف‌کردن پروژه‌های خودت هم صادق است: تغییر کوچک و قابل‌بررسی با دلیل روشن، نه بازنویسی.

## درس‌ها از upstream

- **هشدار غلط lint به fixture مینیمال React/TS نیاز دارد (Biome).** فیکس فقط وقتی merge می‌شود که maintainer بتواند case شکست را در یک تست کوچک و self-contained ببیند. ببین [biomejs/biome #11007](https://github.com/biomejs/biome/pull/11007) — `fix: recognize forwardRef named components with ref params`.
- **لبهٔ فریم‌ورک با reproduction جلو می‌رود، نه شعار (Nitro).** سه PR مستنداتی merge شدند چون هرکدام یک confusion مشخص را pin کردند: [nitrojs/nitro #4442](https://github.com/nitrojs/nitro/pull/4442) (`event.url.pathname` در lifecycle hooks)، [#4445](https://github.com/nitrojs/nitro/pull/4445) (مسیر middleware محدود به route)، و [#4452](https://github.com/nitrojs/nitro/pull/4452) (`minify: false` برای debug کردن workerها).
- **maintainer ابزار به شعاع انفجار اهمیت می‌دهد (Watchexec).** [watchexec/watchexec #1059](https://github.com/watchexec/watchexec/pull/1059) — `docs: quit on Signal::Terminate` — merge شد چون به یک پرسش واقعی termination پاسخ داد، نه یک نیت سبک.
- **PR مستندات وقتی جای خالی واقعی در FAQ را پر می‌کند merge می‌شود (ripgrep).** [BurntSushi/ripgrep #3491](https://github.com/BurntSushi/ripgrep/pull/3491) — `docs(faq): document Windows path separators and UTF-8 locale`.

## یادداشتی دربارهٔ maintainerها

پچ FAQ در ripgrep را Andrew Gallant (BurntSushi)، maintainer ریپگریپ، بررسی و merge کرد. یک اصلاح یک‌خطی مستندات تنها وقتی merge می‌شود که maintainer قبول کند جای خالی واقعی است — اعتبار متعلق به reviewer است که معیار را بالا نگه می‌دارد، نه نویسندهٔ پچ.

همین دربارهٔ PR باز [rust-lang/rust-clippy #17916](https://github.com/rust-lang/rust-clippy/pull/17916) (هنوز در review) صادق است: فیکس `single_component_path_imports` وقتی از طریق `crate::` / `super::` استفاده می‌شود. تا merge نشده، شاهد تلاش و review است، نه اثر منتشرشده.

## مرحلهٔ بعد: قابل‌کشف‌کردن پروژه‌های مستقل

پس از PRهای upstream، کار به مخازن خودم منتقل شد. هدف افزودن قابلیت نبود؛ هدف قابل‌کشف و درست‌attribute کردن کار موجود بود:

- [BTF-Kabir-2020/wireglass](https://github.com/BTF-Kabir-2020/wireglass) — commit [`5cf6607`](https://github.com/BTF-Kabir-2020/wireglass/commit/5cf6607) (`docs: link personal project page`) لینک https://ghourchiani.ir/projects/wireglass را اضافه کرد. فقط مستندات؛ قابلیت جدید نیست.
- [BTF-Kabir-2020/cargo-rust-network-ir](https://github.com/BTF-Kabir-2020/cargo-rust-network-ir) — commit [`5cb8351`](https://github.com/BTF-Kabir-2020/cargo-rust-network-ir/commit/5cb8351) (`docs: link personal project page`) لینک https://ghourchiani.ir/projects/cargo-rust-network-ir را اضافه کرد. فقط قابل‌کشف‌کردن.
- [BTF-Kabir-2020/opencode-browser-agent](https://github.com/BTF-Kabir-2020/opencode-browser-agent) — commit [`89da1d4`](https://github.com/BTF-Kabir-2020/opencode-browser-agent/commit/89da1d4) (`docs: link personal project page`) لینک https://ghourchiani.ir/projects/opencode-browser-agent را اضافه کرد. فقط قابل‌کشف‌کردن.

یک commit جداگانه [`1433236`](https://github.com/BTF-Kabir-2020/opencode-browser-agent/commit/1433236) (`chore: update package homepage`) فیلد `homepage` در `package.json` را به URL صفحهٔ پروژه تغییر می‌دهد. **وضعیت بررسی:** این commit وجود دارد، ولی روی `main` نیست (branch `chore/homepage-metadata-2026-10-28` فعلاً قابل‌مشاهده نیست) و بستهٔ npm منتشرشده (`opencode-browser-agent@2.0.4`) هنوز به README گیت‌هاب اشاره می‌کند. این یک تغییر metadata است، نه قابلیت و نه انتشار.

## درس‌هایی دربارهٔ Git hygiene

- **commitها را کوچک و تک‌منظوره نگه دار.** `docs: link personal project page` دقیقاً می‌گوید چه کرده. reviewer (یا خودم در آینده) diff را در چند ثانیه می‌خواند.
- **مستندات را از قابلیت جدا کن.** لینک صفحهٔ پروژه قابلیت نیست؛ گفتنش به‌عنوان قابلیت کاربر و maintainer را گمراه می‌کند.
- **metadata را از release جدا کن.** تغییر `homepage` در `package.json` یک chore است، نه version bump. آن را به‌عنوان انتشار بازاریابی نکن.
- **پیش از خروج از ماشین، diff را بخوان.** `git diff --check` و خواندن کامل `git diff` فایل‌های تصادفی، مسیرهای شکسته و ویرایش‌های نیمه‌کاره را می‌گیرند.
- **یک منبع تأییدشده برای هر ادعا.** هر PR و commit بالا به URL عمومی و قابل‌بررسی لینک دارد.

## لینک‌ها

- [/fa/blog/biome-forwardref-false-positive](/fa/blog/biome-forwardref-false-positive)
- [/fa/open-source](/fa/open-source)
- [BurntSushi/ripgrep #3491](https://github.com/BurntSushi/ripgrep/pull/3491)
- [biomejs/biome #11007](https://github.com/biomejs/biome/pull/11007)
- [nitrojs/nitro #4442](https://github.com/nitrojs/nitro/pull/4442) · [#4445](https://github.com/nitrojs/nitro/pull/4445) · [#4452](https://github.com/nitrojs/nitro/pull/4452)
- [watchexec/watchexec #1059](https://github.com/watchexec/watchexec/pull/1059)
- [rust-lang/rust-clippy #17916 (در review)](https://github.com/rust-lang/rust-clippy/pull/17916)
- [/fa/projects/wireglass](/fa/projects/wireglass) · [/fa/projects/opencode-browser-agent](/fa/projects/opencode-browser-agent) · [/fa/projects/cargo-rust-network-ir](/fa/projects/cargo-rust-network-ir)
- [/fa/about](/fa/about)
