كيفية ضبط إصدار وثيقة

كيف تعمل

1. اختر قاعدتك للعشري مقابل الرقم الصحيح

   قرّر كتابةً أن المسودة قيد المراجعة تحمل رقماً عشرياً: 0.1، 0.2، 0.3، والنسخة الصادرة تحمل رقماً صحيحاً: 1.0، 2.0. النظام الدقيق أقل أهمية من أن تستخدمه كل وثيقة نفسه، بما في ذلك السجل وكل ترويسة صفحة.

2. ضع الإصدار والتاريخ والمعتمِد على كل صفحة

   رقم الإصدار الذي يعيش فقط في اسم ملف أو خصائص وثيقة يختفي لحظة أن يطبع أحد الصفحة أو يعيد توجيه لقطة شاشة. ضع الإصدار وتاريخ السريان واسم المعتمِد في ترويسة الوثيقة أو تذييلها نفسه.

3. عرّف ما يستحق إصداراً رئيسياً قبل أن تحتاجه

   دوّن المُحفِّز لخطوة الرقم الصحيح (الاعتماد الرسمي وحده، أو الاعتماد مع إعادة كتابة جوهرية للمحتوى) قبل أن تصل أول وثيقة إليه. فريق لا يتفق أبداً على هذا ينتهي بوثيقتين مختلفتين يُسمّى كلتاهما الإصدار 2.

4. اكتب خطوات الترقيم في مخطط، بالترتيب

   افتح مخططاً وضع كل مرحلة (المسودة، والمراجعة، والتنقيح، والاعتماد، والنشر، والإلغاء) في عمود نص المربع، وصِلها عبر عمود الوصل إلى. والتخطيط يُولَّد من تلقاء نفسه، فالقرار الحقيقي الوحيد هو الترتيب الذي يتحرك فيه رقم الإصدار.

5. سمِّ الموقع المعتمد الواحد

   اختر المكان الواحد الذي يعيش فيه الإصدار الحالي (مجلد مضبوط، أو نظام إدارة وثائق، أو رابط QueryChart حي) واجعل كل إحالة أخرى تشير إليه بدل أن تحمل نسخة. رقم الإصدار لا يعني شيئاً إن كانت نسختان «حاليتان» تستطيعان التناقض.

6. اقرأ سجل التغييرات بدل السؤال من لديه أحدث نسخة

   افتح تاريخ إصدارات المخطط واستخدم مقارنة الإصدارات لترى بالضبط أي حقل تغيّر بين تنقيحين، ومن غيّره ومتى، بدل الاحتفاظ بسجل تغييرات موازٍ يدوياً. راجع /features/version-control لمعرفة كيفية عمل سجل التغييرات والاستعادة.

الأسئلة الشائعة

ما ضبط إصدار الوثيقة؟

ضبط إصدار الوثيقة ممارسة منح رقم مميز لكل مسودة ونسخة صادرة من وثيقة، بحيث يستطيع كل من يحمل نسخة أن يعرف مدى حداثتها وعلاقتها بكل نسخة أخرى وُجدت. وهو عادةً يقرن نظاماً عشرياً للمسودات ما زالت قيد المراجعة بأرقام صحيحة للإصدارات المعتمدة رسمياً، ويعتمد على أن تحمل كل صفحة ذلك الرقم بدل تركه في اسم ملف أو سجل منفصل.

كيف أضبط إصدار وثيقة، خطوة بخطوة؟

ثبّت نظام ترقيم قبل أن تصيغ أي شيء: أرقام عشرية للمسودات، أرقام صحيحة للنسخ الصادرة اصطلاح شائع. ضع الإصدار والتاريخ والمعتمِد في ترويسة كل صفحة. وجّه كل مسودة عبر دورة المراجعة والاعتماد نفسها، ترفع الإصدار الفرعي عند كل جولة إعادة عمل والإصدار الرئيسي فقط عند التوقيع الرسمي. احتفظ بموقع حالي معتمد واحد بالضبط، وسِم (لا تحذف أبداً) الإصدار الذي يحل محله الجديد.

ما الفرق بين ضبط الإصدار وضبط التنقيح لوثيقة؟

عملياً يصف المصطلحان الشيء نفسه لوثيقة (نظام لترقيم النسخ المتعاقبة) وتستخدم معظم أنظمة الجودة الكلمتين بالتبادل. الفرق الحقيقي يظهر في سياقات البرمجيات والهندسة، حيث يُلمِّح «ضبط التنقيح» أحياناً إلى تاريخ كامل لمجموعات التغييرات بينما يُستخدم «ضبط الإصدار» بشكل أفضّ لتسمية الرقم وحده. اختر مصطلحاً واحداً واستخدمه باستمرار بدل معاملة فرق غير موجود كأنه ذو معنى؛ راجع /ar/guides/ضبط-التنقيح-مقابل-ضبط-الإصدار للمقارنة الأوفى.

هل أحتاج سجل تغييرات منفصلاً إن كانت لدي أرقام إصدارات أصلاً؟

ليس إن كانت أرقام إصداراتك مدعومة بشيء يسجّل أصلاً من غيّر أي حقل ومتى. يفعل سجل تغييرات QueryChart ذلك تلقائياً لكل تعديل، وتضع مقارنة الإصدارات تنقيحين جنباً إلى جنب وتحدّد الفرق، فسجل التغييرات المحفوظ يدوياً يكرّر عملاً يؤديه المنصة أصلاً. راجع /features/version-control.