افتح الدرس بفقرة تمهيدية تشرح السياق. ما المشكلة التي سنحلها؟ ما القيمة التي سيخرج بها القارئ؟ اكتب بأسلوب مباشر وودّي.
القسم الأول — العنوان هنا
اشرح المفهوم الأساسي. لا تتسرّع — القارئ يحتاج أن يفهم لماذا قبل أن يتعلم كيف.
استخدم هذا الكتلة لأي تحذير أو معلومة حرجة يجب ألا يتجاهلها القارئ. مثال: لا تضع بيانات اعتماد حقيقية في الكود أبداً.
١·١ عنوان فرعي
تفاصيل إضافية أو خطوات. استخدم الفقرات القصيرة — سطرين أو ثلاثة كحد أقصى لكل فقرة.
// مثال: أول سطر كود في الدرس
const greeting = "مرحباً بك في عالم Vibe Coding!";
console.log(greeting);
function buildProject(idea) {
return idea + " → بُني بالذكاء الاصطناعي";
}
استخدم هذه الكتلة للنصائح والاختصارات التي تُسرّع العمل. مثال: يمكنك الضغط على Ctrl+Space في VS Code لرؤية جميع الاقتراحات المتاحة.
القسم الثاني — مثال عملي
بعد الشرح النظري، انتقل مباشرةً للتطبيق. القراء يتعلمون بالفعل، لا بالقراءة فقط.
٢·١ كود متعدد الملفات
# مثال بايثون
def analyze_prompt(text: str) -> dict:
words = text.split()
return {
"length": len(words),
"is_question": text.endswith("؟"),
}
result = analyze_prompt("كيف أبني تطبيقاً بالذكاء الاصطناعي؟")
print(result) # {'length': 6, 'is_question': True}
القسم الثالث — الأخطاء الشائعة
خصّص قسماً للأخطاء التي يقع فيها المبتدئون. هذا من أكثر الأقسام قيمةً للقراء.
صف الخطأ الشائع وسببه. ثم اشرح البديل الصحيح في الفقرة التالية مباشرةً.
البديل الصحيح هو: [اشرح الطريقة الصحيحة هنا].
تطبيق — حان دورك
طبّق ما تعلمته في هذا الدرس. إليك المهام:
- افتح محررك المفضل وأنشئ ملفاً جديداً.
- انسخ الكود الأول من هذا الدرس وشغّله.
- عدّل المتغير
greetingليطبع اسمك. - أضف دالة جديدة تستقبل رقماً وتُعيد مضاعفه.
خلاصة الدرس
لخّص أبرز ما تعلمه القارئ في هذا الدرس. ثلاث إلى خمس نقاط كافية.
النقطة الأهم في هذا الدرس هي [الخلاصة الجوهرية]. احتفظ بها في مكان تراه دائماً.