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