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