feat: add chapter 01-introduction specs

This commit is contained in:
2026-09-05 21:37:25 +08:00
parent bb01742a6a
commit e16cca93ee
7 changed files with 437 additions and 5 deletions

View File

@@ -29,15 +29,15 @@
3. **تفکیک مسئولیت پوشه‌ها:**
هر درس‌نامه یا تمرین در پوشهٔ اختصاصی خود در ساختار زیر قرار می‌گیرد:
- **درس‌نامه:** `chapters/ch<XX>-<name>/<YY>-<lesson-slug>/`
- **درس‌نامه:** `chapters/<XX>-<name>/<YY>-<lesson-slug>/`
- `spec.md` (مشخصات و اهداف یادگیری)
- `README.md` (متن نهایی درس‌نامه کوئرا کالج)
- **تمرین داوری:** `chapters/ch<XX>-<name>/<YY>-<exercise-slug>/`
- **تمرین داوری:** `chapters/<XX>-<name>/<YY>-<exercise-slug>/`
- `spec.md` (مشخصات ورودی/خروجی، سناریو، سنجه‌های داوری)
- `problem.md` (صورت مسئله برای دانشجو)
- `initial/` (کد و اسکلت اولیه)
- `solution/` (پاسخ مرجع و بهینه)
- `tests/` (مجموعه تست‌های داوری خودکار)
- **تمرین تستی:** `chapters/ch<XX>-<name>/<YY>-<quiz-slug>/`
- **تمرین تستی:** `chapters/<XX>-<name>/<YY>-<quiz-slug>/`
- `spec.md` (مشخصات مفهومی و توزیع گزینه‌ها)
- `questions.json` یا `questions.md` (صورت سوال، گزینه‌ها، پاسخ صحیح و تحلیل گزینه‌های گمراه‌کننده)

View File

@@ -13,7 +13,7 @@ description: >-
## ساختار فایل `spec.md` برای درس‌نامه‌ها
هر درس‌نامه باید در مسیر `chapters/ch<XX>-<name>/<YY>-<slug>/spec.md` دارای این قالب باشد:
هر درس‌نامه باید در مسیر `chapters/<XX>-<name>/<YY>-<slug>/spec.md` دارای این قالب باشد:
```markdown
# مشخصات درس‌نامه: [عنوان درس‌نامه]

View File

@@ -18,7 +18,7 @@ description: >-
هر درس‌نامه در پوشهٔ اختصاصی خود درون فصل مربوطه قرار دارد و باید شامل فایل متن درس‌نامه و پوشهٔ تصاویر اختصاصی باشد:
```text
chapters/ch<XX>-<name>/<YY>-<lesson-slug>/
chapters/<XX>-<name>/<YY>-<lesson-slug>/
├── spec.md # سند مشخصات و قرارداد یادگیری درس (ورودی ایجنت)
├── README.md # متن کامل درس‌نامه کوئرا کالج (خروجی نهایی ایجنت)
└── images/ # پوشهٔ اختصاصی تصاویر، نمودارها و دیاگرام‌های درس