التوثيق التقني والتدريب

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

يشمل تقارير التحليل والاختبار، وحزم مراجعة التصميم، وإجراءات التشغيل والصيانة، والمواد التدريبية ثنائية اللغة للفرق التقنية.