feat: add chapter 01-introduction specs
This commit is contained in:
@@ -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` (صورت سوال، گزینهها، پاسخ صحیح و تحلیل گزینههای گمراهکننده)
|
||||
|
||||
@@ -13,7 +13,7 @@ description: >-
|
||||
|
||||
## ساختار فایل `spec.md` برای درسنامهها
|
||||
|
||||
هر درسنامه باید در مسیر `chapters/ch<XX>-<name>/<YY>-<slug>/spec.md` دارای این قالب باشد:
|
||||
هر درسنامه باید در مسیر `chapters/<XX>-<name>/<YY>-<slug>/spec.md` دارای این قالب باشد:
|
||||
|
||||
```markdown
|
||||
# مشخصات درسنامه: [عنوان درسنامه]
|
||||
|
||||
@@ -18,7 +18,7 @@ description: >-
|
||||
هر درسنامه در پوشهٔ اختصاصی خود درون فصل مربوطه قرار دارد و باید شامل فایل متن درسنامه و پوشهٔ تصاویر اختصاصی باشد:
|
||||
|
||||
```text
|
||||
chapters/ch<XX>-<name>/<YY>-<lesson-slug>/
|
||||
chapters/<XX>-<name>/<YY>-<lesson-slug>/
|
||||
├── spec.md # سند مشخصات و قرارداد یادگیری درس (ورودی ایجنت)
|
||||
├── README.md # متن کامل درسنامه کوئرا کالج (خروجی نهایی ایجنت)
|
||||
└── images/ # پوشهٔ اختصاصی تصاویر، نمودارها و دیاگرامهای درس
|
||||
|
||||
Reference in New Issue
Block a user