بلاگبه‌روز 2026-10-28

یادداشت مشارکت upstream: Biome، Nitro، Watchexec، ripgrep

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

نویسنده محمدپویا قورچیانیقورچیانی

engineeringopen-source

پاسخ مستقیم

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

درس‌ها از upstream

  • هشدار غلط lint به fixture مینیمال React/TS نیاز دارد (Biome). فیکس فقط وقتی merge می‌شود که maintainer بتواند case شکست را در یک تست کوچک و self-contained ببیند. ببین biomejs/biome #11007 — fix: recognize forwardRef named components with ref params.
  • لبهٔ فریم‌ورک با reproduction جلو می‌رود، نه شعار (Nitro). سه PR مستنداتی merge شدند چون هرکدام یک confusion مشخص را pin کردند: nitrojs/nitro #4442 (event.url.pathname در lifecycle hooks)، #4445 (مسیر middleware محدود به route)، و #4452 (minify: false برای debug کردن workerها).
  • maintainer ابزار به شعاع انفجار اهمیت می‌دهد (Watchexec). watchexec/watchexec #1059 — docs: quit on Signal::Terminate — merge شد چون به یک پرسش واقعی termination پاسخ داد، نه یک نیت سبک.
  • PR مستندات وقتی جای خالی واقعی در FAQ را پر می‌کند merge می‌شود (ripgrep). BurntSushi/ripgrep #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 (هنوز در review) صادق است: فیکس single_component_path_imports وقتی از طریق crate:: / super:: استفاده می‌شود. تا merge نشده، شاهد تلاش و review است، نه اثر منتشرشده.

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

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

یک 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 عمومی و قابل‌بررسی لینک دارد.

لینک‌ها