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

باختصار

• إصدارات المسودة تأخذ رقماً عشرياً (0.1، 0.2...)؛ والإصدارات الصادرة تأخذ رقماً صحيحاً، لا العكس أبداً.
• اطبع الإصدار والتاريخ والمعتمِد في ترويسة كل صفحة، لا في اسم الملف أو خصائصه فقط.
• احتفظ بموقع حالي معتمد واحد؛ وكل إحالة أخرى ترتبط به بدل أن تحمل نسخة خاصة بها.
• حدّد كتابةً، قبل أن تحتاج أول وثيقة القاعدة، ما يُعدّ رفع إصدار رئيسي مقابل رفع إصدار فرعي.
• يُظهر سجل تغييرات QueryChart وعرض مقارنة الإصدارات بالضبط ما تغيّر بين تنقيحين دون سجل يدوي. راجع /features/version-control.

رقم الإصدار ادّعاء بالثقة

شخصان يحرّران الوثيقة نفسها بلا قاعدة لترقيمها ينتهيان إلى المكان نفسه: ملف اسمه Policy_v2_FINAL_reviewed_USE-THIS-ONE.docx، ولا أحد متيقّن أي من ثلاث نسخ مفتوحة هو الحالي فعلاً. يحلّ ضبط إصدار الوثيقة هذا بثلاثة قرارات ملموسة بدل مجلد مليء بأسماء ملفات مؤرَّخة: نظام ترقيم، وموقع تذكر فيه كل صفحة إصدارها الخاص، وموقع واحد يحتفظ بالنسخة التي يعاملها الجميع كمرجع معتمد.

ضبط الإصدار ليس الشيء نفسه كضبط التغيير، وهو أضيق من ضبط الوثائق. ضبط التغيير هو الآلية التي تقرّر هل يُعتمد تغيير مقترح أصلاً: تقييم الأثر، ولجنة تغيير، وخطة تراجع، وهو يُمشى كعملية قائمة بذاتها على /ar/guides/كيفية-إنشاء-عملية-ضبط-التغيير. أما ضبط الوثائق فدورة الحياة الكاملة التي تعيش الوثيقة داخلها، من الطلب الذي يبدؤها حتى المراجعة الدورية التي تُبقيها سارية، مغطاة من طرف إلى طرف على /ar/guides/كيفية-إنشاء-عملية-ضبط-الوثائق و/ar/templates/عملية-ضبط-الوثائق. هذه الصفحة أضيق من الاثنتين: هي طبقة الترقيم والتتبّع التي تعمل تحت عملية ضبط الوثائق، لا بديلاً عنها.

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

مشاهدة رقم إصدار يتحرّك عبر خمسة مسارات

وثيقة جديدة تُصاغ، وتُنقَّح مرتين، وتُعتمد، وتُنشر، ويُقاعَد إصدارها السابق، يتغيّر رقم الإصدار عند كل واحدة من هذه الخطوات.

1. مسودة تولد عند 0.1

   يفتتح المخطط عند «صياغة وثيقة جديدة»، وقبل أن يُعمَّم الملف قط، يمنحها «تعيين إصدار المسودة الأولي 0.1» رقماً عشرياً: علامة مسودة ما زالت داخل المراجعة الداخلية، لم تُعتمد بعد للاستخدام.

2. كل حلقة إعادة عمل تكسب رقماً عشرياً جديداً

   «هل توجد تعديلات مطلوبة؟» توجّه مسودة تحتاج إعادة عمل عبر «رفع الإصدار الفرعي» إلى «تنقيح المسودة وفق الملاحظات» قبل أن يراها المراجع مجدداً، يصبح 0.1 هو 0.2، فيسمّي الاستشهاد بـ«ملاحظات على 0.3» مسودة واحدة بعينها.

3. الاعتماد هو الباب الوحيد إلى رقم صحيح

   «تقديم المسودة النهائية للاعتماد» و«المعتمِد يراجع المسودة النهائية» يقودان إلى «هل اعتُمدت للإصدار؟»، فرع الاعتماد وحده يصل إلى «تعيين الإصدار الرئيسي 1.0»؛ والرفض يعود إلى حلقة الإصدار الفرعي بدلاً من ذلك.

4. النشر يُقاعد، لا يحذف

   «تحديث سجل تاريخ الإصدارات» صف من نوع ملف لا عملية، ثم يجري «نشر الإصدار المعتمد» و«وسم الإصدار السابق بأنه ملغى» كلاهما قبل أن يفتح أي قارئ النسخة الجديدة، يبقى الرقم القديم في السجل.

5. الوثيقة المنشورة يمكن أن تُفتح مجدداً

   «القارئ يطّلع على الإصدار الحالي» و«هل طُلب تغيير بعد النشر؟» يُظهران أن النشر ليس النهاية: نعم تعيد الوثيقة عبر «إعادة فتح الوثيقة عند الإصدار التالي» إلى المراجعة، بينما لا تصل إلى «الإصدار الحالي يبقى سارياً».

كيف تعمل

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

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

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

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

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

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

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

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

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

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

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

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

أخطاء ينبغي تجنّبها

• أرقام عشرية لا تُحسَم أبداً

  مسودة عالقة عند 0.7 دون أن يرغب أحد في تسميتها نهائية علامة على أن مُحفِّز الاعتماد غير معرَّف، لا مشكلة ترقيم. أصلح قاعدة ما يستحق رقماً صحيحاً، لا عدد الأرقام العشرية.

• رقم الإصدار الذي لا يراه أحد

  إصدار مُتتبَّع فقط في سجل جدول بيانات، غائب عن الوثيقة نفسها، يُجبر القارئ على الوثوق بأن ما بين يديه يطابق السجل. اطبعه على الصفحة بدلاً من ذلك.

• موقعان يُسمّيان كلاهما حالياً

  نسخة على قرص مشترك ونسخة في نظام إدارة وثائق تنحرفان لحظة أن تُحرَّر إحداهما دون الأخرى. اختر الموقع المعتمد الواحد واقفل الباقي أو أوقفه.

• سجل تغييرات يدوي يُحفَظ إلى جانب الوثيقة

  قائمة «ما تغيّر في النسخة 3» محفوظة يدوياً تنحرف عن الوثيقة لحظة أن ينسى أحدهم قيداً. يسجّل سجل تغييرات QueryChart كل تغيير حقل تلقائياً، فقارن إصدارين بدل الوثوق بملاحظة.

أنشئ وثيقتك المضبوطة الإصدار الخاصة بك

افتح مثال ضبط إصدار الوثائق كمخطط خاص بك، واضبط نظام الترقيم لديك، ودع سجل التغييرات يسجّل كل تعديل من هناك.

أنشئ وثيقتك المضبوطة الإصدار الخاصة بك

أدلة ذات صلة

• كيفية ضبط إصدار إجراء تشغيل قياسي
• أفضل ممارسات ضبط إصدار الوثائق
• ضبط الإصدار مقابل ضبط التغيير: ما الفرق

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

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

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

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

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

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

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

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

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