حالة الدليل وخارطة الطريق
صفحة حيّة تتبّع نضج كل فصل وما يحتاج توسعة. ساهم! → دليل المساهمة.
نضج الفصول
| الفصل | الحالة | ملاحظة |
|---|---|---|
| مقدّمة · البدء · خريطة المستودع | ✅ مكتمل | |
| المعمارية (طبقات · خطّ أنابيب · تشابك) | ✅ مكتمل | مخطّطات Mermaid |
| مصدر الحقيقة (فلسفة · language-truth · codegen · grammar SoT) | ✅ مكتمل | الميزة المميِّزة |
| الأماميّة (معجمي · نحوي · AST) | ✅ مكتمل | |
| الخلفيّة: مفسّر · SIR · LLVM | ✅ مكتمل | |
| الخلفيّة: VM | 🚧 قيد التوسعة | يحتاج تفصيل بنية البايت كود |
| الأنظمة (أنواع · أخطاء · مضمنة) | ✅ مكتمل | |
| المساهمة (سير العمل · DoD · الحوكمة) | ✅ مكتمل | |
| مزامنة الدليل (Freshness + كاشف الانجراف) | ✅ مكتمل | فحص آليّ أسبوعيّ |
خارطة الطريق (مقترَحة)
- توسعة VM: تنسيق البايت كود، حلقة التنفيذ، الربط بالمفسّر.
- مزامنة الدليل مع اللغة: بيان ربط + كاشف انجراف + فحص أسبوعيّ → Freshness.
- جسر آليّ لقواعد المحلل: تضمين/مزامنة
docs/parser_rule/_generated/داخل الدليل. - فصل الأدوات: LSP · المنسّق · مدير الحزم (pkg) · sadinfo.
- فصل stdlib: بنية المكتبة القياسية ووحداتها.
- فصل runtime/FFI: ABI المستقلّ وربط VM.
- أمثلة «دراسة حالة»: تتبّع ميزة كاملة عبر كل الطبقات (نهاية-لنهاية).
- ترجمة إنجليزية اختياريّة (i18n).
كيف تُسهم في فصل؟
أنشئ فرع agent/dg-<فصل> من main، طوّر الفصل (مع مخطّط Mermaid وروابط ملف:سطر)،
ابنِ mdbook build بلا أخطاء، ثم افتح PR. أضف الفصل الجديد إلى src/SUMMARY.md.