ضبط الاستشهادات

Spec: ISO/IEC/IEEE 26514Spec: ISO 24495-1

نظرة سريعة

هذه هي الصفحة التي تحيل إليها بقية صفحات ⁨Insider_⁩ عندما تشرح كيف تستشهد بمعيار. فهي تشرح لماذا تعيد هذه المستندات صياغة المواصفات بدلاً من اقتباسها، وكيف يذكر الادعاء المعيار والبند الدقيق الذي يستند إليه، وما الذي يَعِد به الاستشهاد النظيف وما لا يَعِد به.

كُتبت هذه الصفحة لمهندس متمرّس يريد، قبل أن يثق بأي ادعاء، أن يعرف القواعد التي صيغ وفقها — وهذا طلب في محلّه.

لماذا يهمّ هذا

كل صفحة أخرى في ⁨Insider_⁩ تطرح ادعاءات وتربطها بمعيار وبند مُسمّيَين. ولا تكون لهذا الاستشهاد قيمة إلا إذا كان الانضباط الذي يستند إليه واضحاً. فإذا كان “مدعوم بمعيار” قد يعني أي شيء، من “قرأت المواصفة بعناية” إلى “أتذكّر تقريباً ما قالته”، فليس الاستشهاد إلا زينة.

وهناك قيد أصعب أيضاً. فكثير من المستندات التي يلتزم بها ⁨NextPDF⁩ — مثل مواصفات ⁨ISO⁩ و⁨ETSI⁩ وما شابهها — خاضعة للترخيص. ولا يُسمح بإعادة إنتاج نصّها، أياً كان طوله. لذلك يجب أن يحلّ هذا الانضباط مشكلتين معاً: جعل الادعاء قابلاً للتتبّع إلى مصدره، دون إعادة إنتاج ذلك المصدر. واستشهاد دقيق مع إعادة صياغة أمينة يجيبان عن المشكلتين، وهذه الصفحة هي مواصفتهما.

النسخة المختصرة

يعيد ⁨Insider_⁩ صياغة المعايير ولا يقتبس أبداً من المعايير الخاضعة للترخيص. يذكر الادعاء المعيار والبند الدقيق؛ ولا يعيد إنتاج ألفاظ المعيار.
إعادة الصياغة ليست تحايلاً؛ بل هي اختبار فهم. فإعادة صياغة متطلّب بصوت ⁨NextPDF⁩ الخاص تُلزم الكاتب بفهمه، وتحافظ على اتّساق المصطلحات مع المسرد Spec: ISO/IEC/IEEE 26514, §8.
يذكر كل ادعاء مدعوم بمعيار بنداً أو قسماً محدّداً، لا مستنداً كاملاً، حتى يستطيع المراجع التالي فتح ذلك البند وتأكيد صحة إعادة الصياغة مقابله.
يذكر الاستشهاد نوع المصدر الذي يستند إليه — بنداً، أو شِفرة المحرّك، أو اختباراً، أو قياساً — بحيث يظهر أي ادعاء مبالغ فيه من النظرة الأولى.
حين يتعذّر ربط ادعاء ببند قرأه الكاتب فعلاً، لا يُزيَّف الادعاء أبداً. بل يُحتفَظ به، ويُوسَم بأنه غير مُحلٍّ، وتبقى الصفحة غير منشورة — فهذا بروتوكول موثَّق، لا ارتجال.

كيف يتعامل ⁨NextPDF⁩ مع ذلك

إعادة الصياغة، لا الاقتباس

القاعدة الأكثر صرامة في تسلسل أسلوب ⁨NextPDF⁩ تتقدّم على كل دليل أساسي سابق: لا نصّ حرفياً من جهة معايير خاضعة للترخيص، مهما كان المقتطف قصيراً. وبدلاً من ذلك، تذكر الصفحة المعيار والبند، وتعيد صياغة المتطلّب بصوتها الخاص.

غالباً ما يُعرَض هذا بوصفه قيداً ترخيصياً، وهو كذلك فعلاً. لكن الإطار الأنفع هنا تحريري. فالاقتباس الحرفي لا يثبت إلا قدرتك على النسخ. أما إعادة الصياغة الأمينة فتبيّن أنك فهمت البند بما يكفي لصياغته من جديد دون تغيير معناه. كما تتيح للجملة أن تبقى ضمن مفردات ⁨NextPDF⁩ المتّسقة بدلاً من تبديل المستوى اللغوي في منتصف الصفحة، وهو ما يقتضيه نموذج جودة التوثيق Spec: ISO/IEC/IEEE 26514, §8. تُقاس اللغة الواضحة بـ قدرة القارئ على العثور على المحتوى وفهمه واستخدامه، لا بمدى مطابقة النصّ للمصدر Spec: ISO 24495-1, §Introduction؛ إعادة الصياغة تخدم ذلك، أما الاقتباس فلا.

الادعاء يذكر البند، لا المستند وحده

الآلية التي تجعل إعادة الصياغة قابلة للتحقق هي الدقّة. يذكر كل ادعاء مدعوم بمعيار البند أو القسم الدقيق الذي يستند إليه — مثل ⁨ISO 32000-2 §6⁩ — لا المستند وحده. لا يحتاج المراجع إلى الثقة بذاكرة الكاتب؛ بل يفتح ذلك البند ويقارنه بإعادة الصياغة. مرجع البند هو حلقة الوصل بين مصدر لا يجوز اقتباسه وادعاء قابل للتحقق. فهو يحمل موضع البحث لا نصّ المصدر.

الاستشهاد يبيّن نوع هذا المصدر

يجيب الاستشهاد عن سؤال “من أين”. وعليه أن يجيب أيضاً عن سؤال “أي نوع”. فالقول إن ادعاءً يستند إلى بند من معيار وعدٌ يختلف عن القول إنه يستند إلى شِفرة المحرّك نفسها، أو إلى اختبار، أو إلى قياس. يُبقي ⁨NextPDF⁩ هذه الأنواع متمايزة كي يستطيع القارئ الموازنة بينها: تأتي الشِّفرة والاختبارات فوق سلوك وقت التشغيل، ووقت التشغيل فوق البيانات الوصفية، والبيانات الوصفية فوق النصّ. ولا تدّعي صفحة تحريرية كهذه أنها مدعومة بالشِّفرة.

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

هذه الصفحة تحريرية: فهي لا تؤكّد أي سلوك خاص بها للمحرّك. إنها تشرح الانضباط الذي تعتمد عليه استشهادات الصفحات الأخرى. وهذا هو أساسها الصادق، والتصريح بذلك هو الانضباط مطبَّقاً على نفسه.

حين يتعذّر قراءة المصدر

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

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

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

مثال عملي

هذا الانضباط ملموس: فهو يظهر في بنية مقدّمة citations في الصفحة. وكل مُدخَل فيها يربط ادعاءً ببنده.

citations:
  - spec: "ISO 32000-2"
    clause: "§6"
    # NextPDF-worded topic — the paraphrase, never the standard's text
    topic: "A writer's created or amended PDF elements must conform and stay consistent"

لا يوجد حقل quote، وهذا مقصود. وحقل topic هو إعادة صياغة ⁨NextPDF⁩ الخاصة. أما حقلا spec وclause فهما الطريقة التي يعود بها المراجع إلى المصدر بدقة للتحقق من تلك الصياغة. يحمل المُدخَل المؤشّر إلى البند، لا كلمات البند.

مفهوم خاطئ شائع

المزلق هو قراءة “أعد الصياغة ولا تقتبس” بوصفها تحوّطاً — أي وسيلة للظهور بمظهر الموثوق دون التزام. والحقيقة عكس ذلك. فالاقتباس لا يُلزم بشيء؛ إنه يستعير كلمات شخص آخر. أما إعادة الصياغة المُستشهَد بها فتُلزم الكاتب بصياغة يمكن للمراجع أن يدحضها مقابل البند. هذا الانضباط يجعل الادعاءات أكثر خضوعاً للمساءلة، لا أقل.

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

الحدود والنطاقات

تحدّد هذه الصفحة انضباط الاستشهاد؛ وليست ورقة الأسلوب ولا شِفرة البوّابة. المُنتَجات المرجعية موجودة داخل المستودع (docs/style/nextpdf-overrides.md §5، وبرامج composer.jsondocs:*) ولها الأسبقية على أي ملخّص هنا إذا حدث تباين. كما أنها لا تؤكّد أي سلوك للمحرّك.

يُلزِم هذا الانضباط الادعاء، لا استنتاج القارئ. فإعادة الصياغة المُستشهَد بها بأمانة تخبرك بما يتطلّبه البند. أما ما إذا كانت قراءة ⁨NextPDF⁩ هي ما يحتاج إليه التزامك، فهذا يبقى قرارك أنت. ولهذا تحمل الصفحات السلوكية أيضاً استشهادات مدعومة بالشِّفرة أو بالاختبارات، لا استشهادات مدعومة بمعيار وحدها. والإنفاذ جزئي باعتراف صريح: الفحص العامل دون اتصال نشط، أما مُدقّقا الاقتباس الحرفي والاستشهاد الحيّ فموصولان، لكن مُشغّلاتهما الشاملة لا تزال قيد الإنجاز — وهذا معلَن بوصفه قيد الإنجاز، لا بوصفه مكتملاً.

مستندات ذات صلة

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

مسرد المصطلحات

انضباط الاستشهاد — مجموعة القواعد التي تحكم كيفية ربط ادعاء في ⁨Insider_⁩ بمصدره: أعد الصياغة، واذكر البند الدقيق، ولا تقتبس أبداً معياراً خاضعاً للترخيص.
إعادة الصياغة — عرض المتطلّب من جديد بصوت ⁨NextPDF⁩ الخاص المتّسق مع المسرد؛ وهو اختبار الفهم الذي يحلّ محلّ الاقتباس.
مرجع البند — البند أو القسم الدقيق الذي تستند إليه إعادة الصياغة، مُسجَّل بحيث يستطيع المراجع فتحه والتحقق من إعادة الصياغة.
ادعاء مدعوم بمعيار — ادعاء مستند إلى بند مُستشهَد به ومُعاد صياغته من معيار مُسمّى، يتمايز عن ادعاء يستند إلى شِفرة المحرّك أو إلى اختبار أو إلى قياس أو إلى تعليل تحريري.
استشهاد غير مُحلٍّ — ادعاء يتعذّر بعدُ ربطه ببند قرأه الكاتب؛ يُحتفَظ به، ويُوسَم بأنه مفتوح، ويُحجب عن النشر بدلاً من تزييفه.