Semantic Versioning Dashboard
Version Overview
Major Version
تغییرات نسخه Major شامل تغییرات ناسازگار و نیازمند تست کامل است.
Minor Version
تغییرات نسخه Minor قابلیتهای جدید اضافه میکند بدون شکستن عملکرد موجود.
Patch Version
تغییرات نسخه Patch رفع باگ و مشکلات جزئی است بدون افزودن قابلیت جدید.
Pre-release
نسخههای پیشانتشار (مثل RC یا beta) پایدار کامل نیستند و قبل از انتشار نهایی ممکن است تغییر کنند.
Release Notes
- پیروی از قوانین Semantic Versioning: MAJOR.MINOR.PATCH
- تغییرات Major باید ناسازگار با نسخه قبلی باشند
- تغییرات Minor قابلیتهای جدید اضافه میکنند بدون شکستن نسخههای موجود
- تغییرات Patch فقط باید باگها را رفع کنند
- برای نسخههای آزمایشی قبل از انتشار نهایی از pre-release (مثل rc یا beta) استفاده کنید
- اطمینان از سازگاری با نسخههای قبلی در تغییرات Minor
- مدیریت تغییرات ناسازگار در نسخههای Major
- حفظ یکپارچگی و شفافیت در Release Notes
- مدیریت نسخههای pre-release و تست آنها
- استفاده از تست خودکار برای بررسی سازگاری با نسخههای قبلی
- مستندسازی دقیق تغییرات ناسازگار در Release Notes
- تگگذاری نسخههای pre-release در Git (مثال: 1.2.0-rc.1)
- پیروی از استراتژی شاخهبندی منظم برای مدیریت انتشار
- همیشه شماره نسخه را طبق قوانین Semantic Versioning افزایش دهید
- نسخههای pre-release نباید در محیط تولید استفاده شوند
- برای هر انتشار یک Changelog نگه دارید
- از CI/CD برای اتوماسیون انتشار و تگگذاری استفاده کنید
- رعایت دقیق قوانین Semantic Versioning
- اتوماسیون انتشار و تگگذاری با CI/CD
- استفاده از شناسههای واضح برای نسخههای پیشانتشار (rc, beta, alpha)
- اطلاعرسانی واضح تغییرات ناسازگار به کاربران
- رد کردن شماره نسخه یا عدم رعایت قوانین SemVer
- استفاده از Major برای اصلاحات جزئی
- انتشار نسخههای پیشانتشار مستقیم در محیط تولید
- مستندسازی ناقص تغییرات