ضبط الاستشهادات
Spec: ISO/IEC/IEEE 26514 ISO/IEC/IEEE 26514 Spec: ISO 24495-1 ISO 24495-1 Evidence: Editorial
نظرة سريعة
قسم بعنوان «نظرة سريعة»هذه هي الصفحة التي تحيل إليها بقية صفحات Insider_ عندما تذكر “مستوى الأدلة”. فهي تشرح لماذا تعيد هذه المستندات صياغة المعايير بدلاً من اقتباسها، وكيف يرتبط كل ادعاء بمعرّف مرجعي يمكنك التحقق منه مرة أخرى، وما الذي تَعِد به مستويات الأدلة الثمانية وما لا تَعِد به.
كُتبت هذه الصفحة لمهندس متمرّس يريد، قبل أن يثق بأي ادعاء، أن يعرف القواعد التي صيغ وفقها — وهذا طلب في محلّه.
لماذا يهمّ هذا
قسم بعنوان «لماذا يهمّ هذا»كل صفحة أخرى في Insider_ تطرح ادعاءات وتختمها بمستوى أدلة. ولا تكون لهذه العلامة قيمة إلا إذا كان النظام الذي تستند إليه واضحاً. فإذا كان “مدعوم بمعيار” قد يعني أي شيء، من “قرأت المواصفة بعناية” إلى “أتذكّر تقريباً ما قالته”، فليست الشارة إلا زينة.
وهناك قيد أصعب أيضاً. فكثير من المستندات التي يلتزم بها NextPDF — مثل مواصفات ISO وETSI وما شابهها — خاضعة للترخيص. ولا يُسمح بإعادة إنتاج نصّها، أياً كان طوله. لذلك يجب أن يحلّ هذا الانضباط مشكلتين معاً: جعل الادعاء قابلاً للتحقق مقابل مصدره، دون إعادة إنتاج ذلك المصدر. والآلية التي تجيب عن المشكلتين واحدة، وهذه الصفحة هي مواصفتها.
النسخة المختصرة
قسم بعنوان «النسخة المختصرة»- يعيد Insider_ صياغة المعايير ولا يقتبس أبداً من المعايير الخاضعة للترخيص. يستشهد الادعاء بالمعيار والبند والمعرّف المرجعي؛ ولا يعيد إنتاج ألفاظ المعيار.
- إعادة الصياغة ليست تحايلاً؛ بل هي اختبار فهم. فإعادة صياغة متطلّب بصوت NextPDF الخاص تُلزم الكاتب بفهمه، وتحافظ على اتّساق المصطلحات مع المسرد Spec: ISO/IEC/IEEE 26514, §8 ISO/IEC/IEEE 26514 §8 .
- يحمل كل ادعاء مدعوم بمعيار
reference_idمن 64 حرفاً في مقدّمةcitationsفي الصفحة، حتى يستطيع المراجع التالي استرجاع المقطع المصدري نفسه وتأكيد صحة إعادة الصياغة. - تُعلن الشارة عن مستوى أدلة — أحد ثمانية أنواع — يحدّد نوع البرهان، بحيث يظهر أي ادعاء مبالغ فيه من النظرة الأولى.
- حين يتعذّر استرجاع المصدر، لا يُزيَّف الادعاء أبداً. بل يُحتفَظ به، ويُوسَم بأنه غير مُحلٍّ مقابل سجلّ لإعادة التثبيت، وتبقى الصفحة غير منشورة — فهذا بروتوكول موثَّق، لا ارتجال.
كيف يتعامل NextPDF مع ذلك
قسم بعنوان «كيف يتعامل NextPDF مع ذلك»إعادة الصياغة، لا الاقتباس
قسم بعنوان «إعادة الصياغة، لا الاقتباس»القاعدة الأكثر صرامة في تسلسل أسلوب NextPDF تتقدّم على كل دليل أساسي سابق: لا نصّ حرفياً من جهة معايير خاضعة للترخيص، مهما كان المقتطف قصيراً. وبدلاً من ذلك، تستشهد الصفحة بالمعيار والبند، وتعيد صياغة المتطلّب بصوتها الخاص، وتسجّل معرّف المصدر المرجعي.
غالباً ما يُعرَض هذا بوصفه قيداً ترخيصياً، وهو كذلك فعلاً. لكن الإطار الأنفع هنا تحريري. فالاقتباس الحرفي لا يثبت إلا قدرتك على النسخ. أما إعادة الصياغة الأمينة فتبيّن أنك فهمت البند بما يكفي لصياغته من جديد دون تغيير معناه. كما تتيح للجملة أن تبقى ضمن مفردات NextPDF المتّسقة بدلاً من تبديل المستوى اللغوي في منتصف الصفحة، وهو ما يقتضيه نموذج جودة التوثيق Spec: ISO/IEC/IEEE 26514, §8 ISO/IEC/IEEE 26514 §8 . تُقاس اللغة الواضحة بـ قدرة القارئ على العثور على المحتوى وفهمه واستخدامه، لا بمدى مطابقة النصّ للمصدر Spec: ISO 24495-1, §Introduction ISO 24495-1 §Introduction ؛ إعادة الصياغة تخدم ذلك، أما الاقتباس فلا.
الادعاء مرتبط بمعرّف مرجعي، لا بذاكرة
قسم بعنوان «الادعاء مرتبط بمعرّف مرجعي، لا بذاكرة»الآلية التي تجعل إعادة الصياغة قابلة للتحقق هي المعرّف المرجعي. يحمل كل ادعاء مدعوم بمعيار reference_id كاملاً من 64 حرفاً في مقدّمة citations في الصفحة، وهو يحدّد بدقة المقطع المصدري الذي صيغت منه إعادة الصياغة. لا يحتاج المراجع إلى الثقة بذاكرة الكاتب؛ بل يسترجع ذلك المقطع ويقارن. المعرّف المرجعي هو حلقة الوصل بين مصدر لا يجوز اقتباسه وادعاء قابل للتحقق. فهو يحمل موضع البرهان لا نصّ البرهان.
مستوى الأدلة يبيّن نوع البرهان
قسم بعنوان «مستوى الأدلة يبيّن نوع البرهان»يجيب الاستشهاد عن سؤال “من أين”. ويجيب مستوى الأدلة عن سؤال “أي نوع”. تُعلن كل صفحة في Insider_ عن مستوى واحد منها، يظهر في صفّ الشارات، ضمن مجموعة ثابتة من ثمانية. يضع ترتيب الثقة الشِّفرة والاختبارات فوق وقت التشغيل، ووقت التشغيل فوق البيانات الوصفية، والبيانات الوصفية فوق النصّ؛ ولا تدّعي صفحة تحريرية أنها مدعومة بالشِّفرة.
| مستوى الأدلة | ما الذي يَعِد به | ما الذي لا يَعِد به |
|---|---|---|
| Evidence: Code-backed | يُتحقَّق من الادعاء مقابل مصدر المحرّك أو مثال قابل للتشغيل | أن معياراً يفرضه |
| Evidence: Standard-backed | الادعاء مستند إلى بند مُستشهَد به ومُعاد صياغته مع معرّف مرجعي | أن الشِّفرة تنفّذه حالياً دون استثناء |
| Evidence: Test-backed | اختبار في المجموعة يثبّت السلوك في مكانه | رقم أداء |
| Evidence: Benchmark-backed | قياس وفق منهج معلَن يدعم الرقم | الرقم نفسه على عتادك |
| Evidence: Artifact-backed | مُنتَج ناتج (مُخرَج بناء أو تقرير) يثبته | إلزام معياري |
| Evidence: Design principle | قرار تصميم متعمَّد ومُبرَّر | قياس تجريبي |
| Evidence: Editorial | شرح مُعلَّل ينظّم أدلة أخرى | ضمان سلوكي جديد خاص به |
| Evidence: Mixed evidence | تمزج الصفحة بين الأسس وتبيّن أيّها لكل ادعاء | أساس واحد نظيف |
هذه الصفحة Evidence: Editorial : فهي لا تؤكّد أي سلوك خاص بها للمحرّك. إنها تشرح النظام الذي تعتمد عليه شارات الصفحات الأخرى. وهذا هو مستواها الصادق، والتصريح بذلك هو الانضباط مطبَّقاً على نفسه.
حين يتعذّر استرجاع المصدر
قسم بعنوان «حين يتعذّر استرجاع المصدر»الاسترجاع ليس متاحاً دائماً. وتظهر نزاهة هذا الانضباط فيما يحدث عندئذ. فالطابور العادي أو حدّ المعدّل أو التوقّف المؤقت للميزانية ليس انقطاعاً مطلقاً. ينتظر الكاتب. أما الانقطاع الحقيقي فيُطلق إجراءً احتياطياً موثَّقاً: يُحتفَظ بالادعاء محفوظاً، مرتبطاً بأدلة داخل المستودع وبالمرجع المعياري الذي تُعلنه الشِّفرة نفسها، ومُوسوماً صراحةً بأنه غير مُحلٍّ مقابل سجلّ دائم لإعادة التثبيت، وتبقى الصفحة غير منشورة حتى يُثبَّت المعرّف المرجعي فعلاً.
والتصرّفات المحظورة محدّدة وقابلة للفحص: معرّف مرجعي مُلفَّق، أو قيمة مُحشوّة أو مُسبَّقة لتبدو حقيقية، أو بند مكتوب من الذاكرة ومُلبَّس بزيّ استشهاد مُسترجَع، أو حذف الادعاء بصمت تهرّباً من الاستشهاد. إن الانقطاع المُوسوم على نحو صحيح في مسوّدة هو دَين مسجّل، لا عيب. ويفرض فحص حتمي يعمل دون اتصال هذا التمييز بدقة.
ما تقوله الأدلة
قسم بعنوان «ما تقوله الأدلة»هذه الصفحة Evidence: Editorial ، لذلك فأساسها الخاص هو حوكمة التوثيق في هذا المستودع، إضافةً إلى المعايير التي تبرّر هذا الانضباط. والادعاءات هنا قابلة للتحقق بطريقتين: قراءة القواعد داخل المستودع، وإعادة استرجاع البنود المُستشهَد بها.
| الادعاء | الأساس | المرتكز |
|---|---|---|
| إعادة الصياغة تفرض الفهم | معيار | اللغة الواضحة تُقاس بقدرة القارئ على استخدامها، لا بمحاكاة المصدر Spec: ISO 24495-1, §Introduction ISO 24495-1 §Introduction |
| المصطلحات تبقى متّسقة | معيار | كل مصطلح يُستخدم باتّساق في كامل المحتوى Spec: ISO/IEC/IEEE 26514, §8 ISO/IEC/IEEE 26514 §8 |
| المراجعة جزء من العملية | معيار | التحقّق واختبار التصديق داخل التطوير Spec: ISO/IEC/IEEE 26513, §Foreword ISO/IEC/IEEE 26513 §Foreword |
| يمكن التعرّف إلى مستوى الأدلة أولاً | معيار | التعرّف بدلاً من الاستذكار Spec: ISO 9241-110, §5.6.2 ISO 9241-110 §5.6.2 |
| لا نصّ حرفي خاضع للترخيص؛ مُثبَّت بمرجع | داخل المستودع | docs/style/nextpdf-overrides.md §5؛ composer docs:jaccard-fingerprint |
| الإجراء الاحتياطي عند الانقطاع بروتوكول حقيقي | داخل المستودع | حوكمة الإجراء الاحتياطي المعيارية لـ RAG + بوّابة docs:rag-fallback-check العاملة دون اتصال |
مثال عملي
قسم بعنوان «مثال عملي»هذا الانضباط ملموس: فهو يظهر في بنية مقدّمة citations في الصفحة. وكل مُدخَل فيها إيصال لادعاء.
citations: - spec: "ISO 32000-2" clause: "§6" # full 64-char reference ID — the join to the source span, re-verifiable reference_id: "<64-hex digest>" # 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 الخاصة. أما حقل reference_id فهو الطريقة التي يعود بها المراجع إلى المصدر بدقة للتحقق من تلك الصياغة. يحمل الإيصال المؤشّر إلى البرهان، لا كلمات البرهان.
مفهوم خاطئ شائع
قسم بعنوان «مفهوم خاطئ شائع»المزلق هو قراءة “أعد الصياغة ولا تقتبس” بوصفها تحوّطاً — أي وسيلة للظهور بمظهر الموثوق دون التزام. والحقيقة عكس ذلك. فالاقتباس لا يُلزم بشيء؛ إنه يستعير كلمات شخص آخر. أما إعادة الصياغة المُستشهَد بها فتُلزم الكاتب بصياغة يمكن للمراجع أن يدحضها مقابل المصدر. هذا الانضباط يجعل الادعاءات أكثر خضوعاً للمساءلة، لا أقل.
المزلق الثاني هو التعامل مع “تحريري” بوصفه درجة أضعف من “مدعوم بمعيار”. لكنه ليس درجة أصلاً؛ بل هو نوع مختلف. فصفحة تحريرية كهذه تنظّم أدلة أخرى وتشرحها. وهي موسومة على نحو صحيح. والوسم هو المقصد: يعمل النظام لأن الصفحة تخبرك بنوع البرهان الذي تقدّمه قبل أن تقرّر مقدار الوزن الذي تمنحه له.
الحدود والنطاقات
قسم بعنوان «الحدود والنطاقات»تحدّد هذه الصفحة انضباط الاستشهاد؛ وليست ورقة الأسلوب، ولا حوكمة الإجراء الاحتياطي، ولا شِفرة البوّابة. المُنتَجات المرجعية موجودة داخل المستودع (docs/style/nextpdf-overrides.md §5، وحوكمة الإجراء الاحتياطي المعيارية لـ RAG، وبرامج composer.jsondocs:*) ولها الأسبقية على أي ملخّص هنا إذا حدث تباين. كما أنها لا تؤكّد أي سلوك للمحرّك.
يُلزِم هذا الانضباط الادعاء، لا استنتاج القارئ. فإعادة الصياغة المُستشهَد بها بأمانة تخبرك بما يتطلّبه البند. أما ما إذا كانت قراءة NextPDF هي ما يحتاج إليه التزامك، فهذا يبقى قرارك أنت. ولهذا تحمل الصفحات السلوكية أيضاً أدلة مدعومة بالشِّفرة أو بالاختبارات، لا أدلة مدعومة بمعيار وحدها. والإنفاذ جزئي باعتراف صريح: فحص الإجراء الاحتياطي العامل دون اتصال نشط، أما مُدقّقا الاقتباس الحرفي والاستشهاد الحيّ فموصولان، لكن مُشغّلاتهما الشاملة لا تزال قيد الإنجاز — وهذا معلَن بوصفه قيد الإنجاز، لا بوصفه مكتملاً.
مستندات ذات صلة
قسم بعنوان «مستندات ذات صلة»- التوثيق بوصفه منتجاً — انضباط الجودة الأوسع الذي يُعدّ نظام الاستشهاد هذا جزءاً منه.
- مشهد المعايير — المعايير التي تشير إليها هذه الاستشهادات، وكيف يتحوّل البند إلى سلوك موثَّق.
- هرم اختبارات NextPDF — معنى الدليل المدعوم بالاختبارات عندما تدّعي صفحة ذلك المستوى بدلاً من هذا.
مسرد المصطلحات
قسم بعنوان «مسرد المصطلحات»- انضباط الاستشهاد — مجموعة القواعد التي تحكم كيفية ربط ادعاء في Insider_ بمصدره: أعد الصياغة، واستشهد بالبند، وثبّت معرّفاً مرجعياً، ولا تقتبس أبداً معياراً خاضعاً للترخيص.
- إعادة الصياغة — عرض المتطلّب من جديد بصوت NextPDF الخاص المتّسق مع المسرد؛ وهو اختبار الفهم الذي يحلّ محلّ الاقتباس.
reference_id— مؤشّر السلامة الكامل المؤلَّف من 64 حرفاً للمقطع المصدري الدقيق الذي صيغت منه إعادة الصياغة، مُسجَّل بحيث يستطيع المراجع استرجاعه والتحقق منه.- مستوى الأدلة — نوع البرهان المُعلَن وراء ادعاءات الصفحة، واحد من ثمانية (مدعوم بالشِّفرة، مدعوم بمعيار، مدعوم باختبار، مدعوم بقياس مرجعي، مدعوم بمُنتَج، مبدأ تصميم، تحريري، مختلط)، يظهر في صفّ الشارات.
- استشهاد غير مُحلٍّ — ادعاء تعذّر تثبيت معرّفه المرجعي بسبب انقطاع استرجاع حقيقي؛ يُحتفَظ به، ويُوسَم مقابل سجلّ لإعادة التثبيت، ويُحجب عن النشر بدلاً من تزييفه.