13.11. مشارکت
افزودن یادداشت انتشار
پوشه doc/manual/rl-next حاوی ورودیهای یادداشت انتشار برای تمام تغییرات منتشرنشده است.
تغییرات قابلمشاهده برای کاربر باید همراه با یک یادداشت انتشار ارائه شوند.
افزودن یک ورودی
در اینجا نمونهای از یک ورودی کامل آورده شده است. نام فایل در سند ادغام نمیشود.
---
synopsis: Basically a title
issues: 1234
prs: 1238
---
Here's one or more paragraphs that describe the change.
- It's markdown
- Add references to the manual using [links like this](/pages/nix-manual/development/example)تغییرات مهم باید هدر زیر را اضافه کنند تا به بالا منتقل شوند.
significance: significantهمچنین میتوانید مستندات قالب را مطالعه کنید.
فرآیند ساخت
نسخهها دارای یک فایل rl-MAJOR.MINOR.md ازپیشمحاسبهشده هستند و فاقد فایل rl-next.md میباشند.
شاخهها
-
شاخه اصلی توسعه. تمام تغییرات در این شاخه تایید و ادغام میشوند. هنگام توسعه یک تغییر، شاخهای را بر اساس آخرین نسخه
masterایجاد کنید.نگهدارندگان تلاش میکنند تا آن را در وضعیتی آماده برای انتشار نگه دارند.
-
این شاخهها صرفاً موضوع انتقالهای معکوس (backports) هستند و آنها نیز در وضعیتی آماده برای انتشار نگهداری میشوند.
به
maintainers/backporting.mdمراجعه کنید. -
آخرین نسخه پچ از آخرین نسخه فرعی.
به
maintainers/release-process.mdمراجعه کنید. -
بهطور کلی شاخههایی که توسط اکشن انتقال معکوس ایجاد شدهاند.
به
maintainers/backporting.mdمراجعه کنید. -
شاخههایی که با الگوهای فوق مطابقت ندارند باید شاخههای ویژگی (feature branches) باشند.
بازگردانی
اگر مشخص شود که تغییری به اشتباه ادغام شده است یا حاوی یک رگرسیون (regression) است، ممکن است بازگردانی شود. بازگردانی به معنای رد کردن مشارکت نیست، بلکه صرفاً بخشی از یک فرآیند توسعه مؤثر است. این کار تضمین میکند که توسعه با روانترین شکل ممکن، حداقل میزان ابهام و سربار کمتر ادامه یابد. اگر نگهدارندگان مجبور باشند بیش از حد نگران جلوگیری از بازگردانیها باشند، نمیتوانند به همان میزان تغییرات را ادغام کنند. با پذیرش بازگردانیها به عنوان بخش مثبتی از فرآیند توسعه، همه برنده میشوند.
با این حال، عقبنشینی ممکن است ناامیدکننده باشد، بنابراین نگهدارندگان در تلاش بعدی حمایت ویژهای از شما خواهند کرد.