سجل التغييرات
سجل التغييرات
قسم بعنوان «سجل التغييرات»تشمل منظومة NextPDF حزمًا ومستودعات عديدة. توضّح هذه الصفحة كيف تُسجِّل المنظومة التغييرات، وأين تحتفظ كل حزمة بسجل التغييرات الخاص بها. استخدمها فهرسًا ومرجعًا للاصطلاحات، لا قائمةً تعيد ذكر كل إيداع (commit). تحتفظ كل حزمة بسجل التغييرات المُصدَر المعتمد في مستودعها الخاص. ويلخّص الجدول فئة التغيير لكل إصدار مُصدَر فقط، استنادًا إلى سِجل Conventional Commits في كل مستودع.
بصفتها فهرسًا للوثائق، لا تقدّم هذه الصفحة أي ادّعاءات عن سلوك أي حزمة. للاطّلاع على القواعد التي تتبعها كل حزمة عند كتابة الإيداعات وإصدار النسخ، راجع اصطلاحات سجل التغييرات.
كيف تُسجَّل التغييرات
قسم بعنوان «كيف تُسجَّل التغييرات»يلتزم كل مستودع عام من NextPDF باتفاقيتين:
- Conventional Commits 1.0.0 — يستخدم موضوع كل إيداع الصيغة
type(scope): description، حيث يكونtypeواحدًا منfeat،fix،perf،refactor،docs،test،build،ci،chore، أوrevert. تشير علامة!بعد type/scope، أو تذييلBREAKING CHANGE:، إلى تغيير غير متوافق. وتُوسَم الإصلاحات ذات الصلة بالأمان لتسهيل تصفيتها. - Semantic Versioning 2.0.0 — يرفع
featالإصدارَ الفرعي (minor)، ويرفعfix/perfإصدارَ الترقيع (patch)، ويرفع التغيير الكاسر الإصدارَ الرئيسي (major). ويجمع ملفCHANGELOG.mdالمُصدَر في كل مستودع مداخل التغيير المقروءة للبشر حسب الإصدار، مستخدمًا أقسام Keep a Changelog.
يغطّي الموجز أدناه الفئات المُوجَّهة للمستخدم فقط: feat (قدرة جديدة)، fix (سلوك مُصحَّح)، perf (أداء)، security (إصلاح ذو صلة بالأمان)، والتغييرات الكاسرة. أمّا أنواع الإيداعات الداخلية البحتة (docs، test، ci، chore، refactor) فمستبعَدة عمدًا من الموجز العابر للمستودعات. فهي لا تُغيّر ما تلاحظه عند استخدام الحزمة.
أين يوجد سجل التغييرات لكل حزمة
قسم بعنوان «أين يوجد سجل التغييرات لكل حزمة»سجل التغييرات النصي المعتمد لكل حزمة هو ملف CHANGELOG.md في مستودع الحزمة نفسها، ويكون مُجمَّعًا حسب الإصدار المُصدَر. للاطّلاع على النص الكامل للمدخل، استخدم صفحة الإصدار في المستودع أو ملف CHANGELOG.md. ولا يُكرّر هذا الفهرس ذلك النص.
| الحزمة | المستودع | سجل التغييرات المعتمد |
|---|---|---|
nextpdf/core | nextpdf | CHANGELOG.md (Keep a Changelog) |
nextpdf/server | nextpdf-server | CHANGELOG.md |
nextpdf/laravel | nextpdf-Laravel | CHANGELOG.md |
nextpdf/symfony | nextpdf-Symfony | CHANGELOG.md |
nextpdf/codeigniter | nextpdf-CodeIgniter | CHANGELOG.md |
nextpdf/artisan | nextpdf-Artisan | CHANGELOG.md |
nextpdf/gotenberg | nextpdf-Gotenberg | CHANGELOG.md |
nextpdf/cloudflare | nextpdf-Cloudflare | CHANGELOG.md |
nextpdf/compat-legacy | nextpdf-compat-tcpdf | CHANGELOG.md |
nextpdf (روابط Python) | nextpdf-python | CHANGELOG.md |
موجز عبر المستودعات — الفئات في أحدث إصدار مُصدَر لكل حزمة
قسم بعنوان «موجز عبر المستودعات — الفئات في أحدث إصدار مُصدَر لكل حزمة»يُولَّد هذا الجدول مرجعًا للقراءة فقط من سِجل Conventional Commits في كل مستودع عند أحدث وسم مُصدَر. وهو يحصي الفئات المُوجَّهة للمستخدم ويعرض أعداد الفئات فقط — لا مواضيع الإيداعات الخام — ولذلك لا يكشف المُعرّفات الداخلية ولا أسماء الفروع ولا مراجع التخطيط. للاطّلاع على التفصيل النصي وراء أي سطر، راجع ملف CHANGELOG.md الخاص بالحزمة.
| الحزمة | أحدث إصدار مُصدَر | قدرة جديدة (feat) | إصلاحات (fix) | أداء (perf) | أمان | كاسر |
|---|---|---|---|---|---|---|
nextpdf/core | v5.2.0 | 317 | 290 | 1 | 1 | نعم |
nextpdf/server | v0.1.0 | 15 | 16 | 0 | 0 | لا |
nextpdf/laravel | v0.1.0 | 1 | 8 | 0 | 0 | لا |
nextpdf/symfony | v0.1.0 | 1 | 7 | 0 | 0 | لا |
nextpdf/codeigniter | v0.1.0 | 1 | 10 | 0 | 0 | لا |
nextpdf/artisan | v0.1.0 | 1 | 7 | 0 | 0 | لا |
nextpdf/gotenberg | v0.1.0 | 0 | 6 | 0 | 0 | لا |
nextpdf/cloudflare | v0.1.0 | 0 | 8 | 0 | 0 | لا |
nextpdf/compat-legacy | v0.1.0 | 1 | 8 | 0 | 0 | لا |
nextpdf (Python) | v1.1.0 | 7 | 5 | 0 | 0 | لا |
الأعداد تراكمية حتى الوسم المذكور. وفي كل حزمة تكامل، يتضمّن أول إصدار موسوم تاريخها الكامل السابق للإصدار 1.0. وتعرض خلية “Breaking” الخاصة بـ
nextpdf/coreالقيمةyesلأن المحرك الأساسي أصدر إصدارات رئيسية كاسرة. أمّا تفاصيل كل إصدار ومسار الانتقال الخاص بكل منها فتوجد في ملفCHANGELOG.mdفي المستودع الأساسي وفي أدلةmigration/الخاصة به. ولا يُعيد هذا الفهرس ذكرها.
ما تتعمّد هذه الصفحة إغفاله
قسم بعنوان «ما تتعمّد هذه الصفحة إغفاله»للحفاظ على سجل التغييرات العام خاليًا من أي تسريب داخلي، لا يكشف هذا الفهرس أبدًا أيًّا مما يلي:
- مواضيع الإيداعات الخام أو متونها؛
- المُعرّفات الداخلية للمسائل أو التذاكر أو الدورات أو الموجات أو بنود العمل؛
- أسماء الفروع الخاصة أو العمل قيد التنفيذ غير المُصدَر؛
- خارطة الطريق أو الميزات غير المُعلَنة؛
- نسبة أتمتة المساهمين.
لا يظهر أي تغيير هنا إلا بعد أن يصبح جزءًا من إصدار مُصدَر وموسوم لحزمة عامة. ولا يظهر العمل غير المُصدَر.