مركز تعلّم الذكاء الاصطناعيEnglish
ترجمة عربية جديدة ✦ نراجعها باستمرار لتحسينها.

سؤال أوراق العمل

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

ما الذي دخل، وما الذي خرج

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

  • ما دخل: المستندات، والمجتمع، والنسخة، وما استُبعد
  • ما خرج: المخرجات التي اعتُمد عليها، محفوظة كما أُنتجت لا كما تُذكر
  • ما فعله المدقّق، ولماذا كان الاعتماد معقولًا، يربطان المخرجات بالاستنتاج
  • التقط ذلك في حينه، فالمدخلات والمخرجات نادرًا ما يمكن إعادة بنائها لاحقًا

المراجِع، والمفتّش بعد ثلاث سنوات

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

  • قارئان: المراجِع هذا العام، ومفتّش بعد سنوات يقرأ دون سياق
  • الاختبار: اشرح الاعتماد من الملف وحده، دون وجود الأداة
  • الأدوات تُحدَّث وتُستبدل وتُوقف؛ ولا يجوز أن يعتمد الملف على عرض حي
  • ملفات التدقيق تُقرأ بعد سنوات على يد أشخاص واجبهم الشك فيك

لقطة الشاشة ليست تفسيرًا

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

  • لقطة الشاشة تسجّل ما عُرض، ولا تجيب عن أيٍّ من الأسئلة الأربعة التي يجب أن يجيب عنها الملف
  • الشكل دون المضمون هو التحذير المتكرر في هذه الدورة، هنا في صورة مصغّرة
  • صدّر المدخلات والمخرجات حيثما أمكن؛ وسجّل الإعدادات والتاريخ
  • فقرة الاستدلال الصادق القصيرة تعيش أطول من أي واجهة