نظام الملاحظات
المسار: الكتابة باللمس وإنتاجية المبرمج الوحدة: الإنتاجية للمبرمج
مدخل إلى الدرس: نظام الملاحظات
في هذا الدرس من مسار الكتابة والإنتاجية على أديب الصلوي: دفتر مشروع واحد (Obsidian، Notion، أو markdown في repo) يخزن قرارات التصميم وروابط المراجع.…
طريقة الدراسة: اقرأ التعريف، تتبّع المثال في الشرح، نفّذه بنفسك، ثم اختبر النتيجة والحالات الاستثنائية قبل الانتقال.
مقدمة الدرس
دفتر مشروع واحد (Obsidian، Notion، أو markdown في repo) يخزن قرارات التصميم وروابط المراجع.
هيكل بسيط
Inbox → مشروع → أرشيف؛ لا أكثر من 3 مستويات.
- اربط الملاحظة بمسار الملف أو issue.
- راجع inbox يوم الجمعة.
للكتابة
اختصارات لقوالب meeting وADR تسرع التوثيق.
أخطاء شائعة
- ملاحظات مبعثرة في 10 تطبيقات.
- توثيق بعد نسيان التفاصيل.
- نسخ لصق بدون عنوان.
تمرين تطبيقي: أنشئ ملاحظة «قرار اليوم» بصيغة: السياق، القرار، البدائل.
معجم المصطلحات
- الملاحظات
- Second brain for dev.
- ADR
- Architecture decision record.
هذا الدرس ضمن مسار الكتابة باللمس وإنتاجية المبرمج على منصة أديب الصلوي (Adeeb Al-Silwy).
مثال عملي للتطبيق
الموقف: نعمل على برنامج صغير لحل مشكلة يومية مع مدخلات ونتائج يمكن التحقق منها. نحتاج إلى توظيف فكرة نظام الملاحظات لتلبية مطلب محدد يمكن قياس نجاحه.
- حدد البيانات أو المكونات ذات العلاقة في المثال.
- طبّق خطوات الموضوع على نسخة تجريبية بسيطة، ودوّن الناتج المتوقع قبل التنفيذ.
- جرّب حالة صحيحة وحالة خاطئة، وقارن النتيجة بالسلوك المتوقع.
معيار النجاح: تستطيع تفسير السبب وراء كل خطوة وإعادة تنفيذ المثال دون الرجوع إلى الحل.
مراجعة وتمرين تثبيت المهارة
اختبار سريع: اشرح بعبارتك معنى «نظام الملاحظات»، ثم بيّن أين ستستخدمه داخل برنامج صغير لحل مشكلة يومية مع مدخلات ونتائج يمكن التحقق منها، وما الخطأ الذي يجب اختباره قبل الاعتماد على الحل.
تحدٍّ إضافي: غيّر شرطًا واحدًا في التطبيق، وتوقع النتيجة، ثم نفّذ الاختبار وفسّر الاختلاف.
الدرس التالي: العمل الموجّه بالمهام. من الأفضل إنهاء التجربة الحالية قبل متابعة الدرس التالي.
