العربية · How-to guide

دليل عملي يمكن اتباعه فعلًا

للكتابة التعليمية مقياس واحد للجودة: هل استطاع القارئ فعل ذلك بعد القراءة أم لا.

ابدأ من نقطة انطلاق القارئ

اكتب ثلاثة أشياء واجعلها أمامك: ما الذي يجيده أصلًا، وما الذي بين يديه، وكيف يبدو "الإنجاز" — نتيجة ملموسة لا شعورًا.

حلّل المهمة قبل الكتابة

اسرد كل فعل بالترتيب، حتى ما يبدو بديهيًا: عنده يتعثر المبتدئ. ولكل فعل دوّن: ما الذي يجب أن يكون جاهزًا قبله، وماذا يفعل، وكيف يعرف أنه نجح، وما الذي يفسد عادة.

كيف تُكتب الخطوة

• فعل واحد لكل خطوة. إذا ظهرت "و" فالأرجح أنهما خطوتان.
• ابدأ بالفعل: "افتح الملف"، لا "ستحتاج إلى فتح الملف".
• الشرط أولًا: "إذا التصقت العجينة فأضف الدقيق".
• قل ما الذي ينبغي أن يراه الآن. بلا نقاط تحقق يكتشف خطأ الخطوة الرابعة عند التاسعة عشرة.
• ضع الخطأ مع خطوته، لا في ملحق آخر الكتاب.

تحقق من كل تفصيل

يصف النموذج بثقة تامة قائمة لا وجود لها. طابق أسماء الأزرار والإصدارات والأسعار والحدود القانونية بالواقع. وإذا تعلق الدليل بالكهرباء أو الغاز أو الطعام أو الدواء أو المال فليقرأه مختص قبل النشر.

أسئلة شائعة