پاسخ مستقیم
تغییر کوچک با شاهد سریعتر از 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 کردن کار موجود بود:
- BTF-Kabir-2020/wireglass — commit
5cf6607(docs: link personal project page) لینک https://ghourchiani.ir/projects/wireglass را اضافه کرد. فقط مستندات؛ قابلیت جدید نیست. - 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 — commit
89da1d4(docs: link personal project page) لینک https://ghourchiani.ir/projects/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/open-source
- BurntSushi/ripgrep #3491
- biomejs/biome #11007
- nitrojs/nitro #4442 · #4445 · #4452
- watchexec/watchexec #1059
- rust-lang/rust-clippy #17916 (در review)
- /fa/projects/wireglass · /fa/projects/opencode-browser-agent · /fa/projects/cargo-rust-network-ir
- /fa/about