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