إنشاء سجلات التغييرات وملاحظات الإصدارات
تعلّم كيفية إعداد سجلات تغييرات واضحة وملاحظات إصدارات آلية من سجل Git والـ conventional commits.
إنشاء سجلات التغييرات وملاحظات الإصدارات درس مجاني في DevOps Bootcamp على CoddyKit. هذا هو الدرس 4 من أصل 4. يمكنك قراءة الدرس كاملاً أدناه مجاناً — ثم تمرن عليه مباشرة في المتصفح باستخدام محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7. هذا الدرس جزء من مسار التعلم في DevOps Bootcamp، وتقدمك يتزامن عبر الويب وتطبيق CoddyKit. تتضمن دورة DevOps Bootcamp 4 دروس في المجموع.
ما هو سجل التغييرات؟
سجل التغييرات هو قائمة منتقاة وسهلة القراءة للتغييرات المهمة في كل إصدار. ويوجد في ملف مثل CHANGELOG.md في جذر المستودع.
أهمية سجلات التغييرات
يقرأ المستخدمون وأعضاء الفريق سجلات التغييرات لفهم ما يلي:
- الميزات الجديدة
- إصلاحات الأخطاء
- التغييرات غير المتوافقة
تجعل هذه السجلات عمليات الترقية أكثر أمانًا وسرعة.
تنسيق Keep a Changelog
يصنّف أحد التنسيقات الشائعة الإدخالات تحت العناوين التالية: Added وChanged وFixed وRemoved.
## [1.2.0] - 2024-05-01
### Added
- Search filters
### Fixed
- Login redirect bugالالتزامات وفق Conventional Commits
تستخدم الالتزامات وفق Conventional Commits بادئات مثل feat: وfix: وBREAKING CHANGE:، بحيث تستطيع الأدوات إنشاء سجلات التغييرات تلقائيًا.
feat: add CSV export
fix: handle empty cart
feat!: drop Node 14 supportسرد الالتزامات منذ وسم
يمكنك معاينة ما تغيّر منذ الإصدار الأخير باستخدام git log مع نطاق من الوسوم.
git log v1.1.0..HEAD --onelineسجل منسّق لملاحظات الإصدار
نسّق السجل في أسطر على شكل نقاط لتكون مناسبة للنسخ واللصق في ملاحظات الإصدار.
git log v1.1.0..HEAD --pretty=format:'- %s'أدوات إنشاء سجلات التغييرات تلقائيًا
تقرأ أدوات مثل standard-version أو conventional-changelog الالتزامات وفق Conventional Commits، وتنشئ سجل التغييرات بالإضافة إلى تحديث رقم الإصدار.
npx standard-versionملاحظات GitHub المُنشأة تلقائيًا
يمكن لـ GitHub إنشاء ملاحظات الإصدار تلقائيًا من طلبات السحب المدمجة عند إنشاء إصدار.
gh release create v1.2.0 --generate-notesالتصنيف باستخدام التصنيفات
يربط ملف .github/release.yml تصنيفات طلبات السحب بأقسام سجل التغييرات، فتُجمّع ملاحظات إصلاحات الأخطاء والميزات تلقائيًا.
changelog:
categories:
- title: Features
labels: [feature]المراجعة قبل النشر
اقرأ الملاحظات المُنشأة دائمًا قبل نشرها. تنشئها الأتمتة كمسودة، لكن على شخص مراجعة الصياغة وإبراز التغييرات غير المتوافقة.
الربط بالإصدارات
احرص على ربط كل إدخال في سجل التغييرات بوسم Git وصفحة الإصدار، حتى يتمكن القراء من الانتقال إلى الفروقات الدقيقة.
[1.2.0]: https://github.com/you/repo/compare/v1.1.0...v1.2.0تحقق سريع
اختبر مدى فهمك لسجلات التغييرات وملاحظات الإصدار.
مراجعة
لقد تعلمت إنشاء سجلات التغييرات:
- استخدم تنسيق Keep a Changelog
- تدعم الالتزامات وفق Conventional Commits الأتمتة
- يعاين
git log v1..HEADالتغييرات - ينشئ
gh release create --generate-notesمسودة ملاحظات من طلبات السحب
الأسئلة الشائعة
هل درس «إنشاء سجلات التغييرات وملاحظات الإصدارات» مجاني؟
نعم — نص درس «إنشاء سجلات التغييرات وملاحظات الإصدارات» كامل متاح مجاناً هنا على الويب. لتمرينه بشكل تفاعلي (محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7) وفتح باقي دورة DevOps Bootcamp، انتقل إلى CoddyKit PRO. تتضمن دورة DevOps Bootcamp 4 دروس في المجموع.
ماذا ستتعلم في «إنشاء سجلات التغييرات وملاحظات الإصدارات»؟
تعلّم كيفية إعداد سجلات تغييرات واضحة وملاحظات إصدارات آلية من سجل Git والـ conventional commits. تتمرن على DevOps Bootcamp مع أكواد عملية تشغلها مباشرة في المتصفح، ومدرس ذكاء اصطناعي متاح 24/7 يجيب على أسئلتك أثناء عملك.
هل أحتاج إلى خبرة سابقة لأبدأ DevOps Bootcamp؟
لا تُشترط خبرة سابقة. DevOps Bootcamp على CoddyKit منظم للمبتدئين حتى المتقدمين، لذا يمكنك البدء من هنا أو من البداية والتقدم بسرعتك الخاصة. هذا هو الدرس 4 من أصل 4.
كم من الوقت يستغرق درس «إنشاء سجلات التغييرات وملاحظات الإصدارات»؟
معظم دروس CoddyKit تستغرق حوالي 5–10 دقائق. كل منها موجز وتفاعلي، لذا تحرز تقدماً مستمراً وتستأنف من حيث توقفت عبر الويب والتطبيق.
هل يمكنني كتابة وتشغيل أكواد في درس DevOps Bootcamp هذا؟
نعم. كل درس في DevOps Bootcamp يتضمن محرر أكواد مدمج، لذا تكتب وتشغل أكواداً حقيقية مباشرة في متصفحك وتحصل على تعليقات فورية من الذكاء الاصطناعي — بدون إعداد محلي.
جميع الدروس في هذه الدورة
- الإصدارات الدلالية باستخدام الوسوم
- إنشاء الإصدارات وإدارتها
- فروع الإصدارات والإصلاحات العاجلة
- إنشاء سجلات التغييرات وملاحظات الإصدارات