دليل مطوّري لغة ص — الأنظمة الداخلية

مرجع المطوّرين الذين يطوّرون لغة ص نفسها (المفسّر، المترجم، الأنظمة الداخلية) — لا مَن يكتبون برامج بها. مبنيّ كـmdBook، مستوحى من rustc-dev-guide ومُصمَّم ليكون أوضح تنظيمًا وأكثر تطوّرًا: معماريّة طبقيّة صريحة + مصدر حقيقة موحّد (data-driven) يميّز لغة ص.

🌐 النسخة المنشورة: https://sadlang.github.io/dev-guide/ (تُبنى آليًّا من main).

ما الذي يميّز هذا الدليل؟

	rustc-dev-guide	دليل لغة ص
البنية	فصول مسطّحة	أجزاء مُرقّمة (بدء → معمارية → SoT → أمام → خلف → أنظمة → مساهمة)
القواعد النحويّة	نثر + كود المحلل	مصدر موحّد YAML (language-truth/grammar/) يُولِّد التوثيق والمخطّطات
بيانات اللغة	موزّعة في الكود	language-truth/ SoT (كلمات/عوامل/أنواع/أخطاء/مضمنة) + codegen
المخطّطات	محدودة	Mermaid لكل خطّ أنابيب وكل تدفّق
المساهمة	فروع + PR	worktrees معزولة + فرع dev محميّ + PR موقّع GPG

البناء محليًّا

cargo install mdbook mdbook-mermaid
mdbook-mermaid install .      # يُضيف أصول mermaid
mdbook serve --open          # معاينة حيّة على http://localhost:3000
mdbook build                 # ينتج ./book

البنية

dev-guide/
├── book.toml            ← إعداد mdBook
├── src/
│   ├── SUMMARY.md       ← الفهرس (شجرة الفصول)
│   ├── introduction.md
│   ├── getting-started/ · architecture/ · sot/ · frontend/ · backend/ · systems/ · contributing/
│   └── glossary.md
└── theme/rtl.css        ← دعم العربية (RTL)

المصادر المرتبطة

• المستودع الرئيسيّ: sadlang/s-programming-language
• مصدر الحقيقة: language-truth/ · قواعد المحلل: language-truth/grammar/ + docs/parser_rule/_generated/
• مهارة التطوير: .github/skills/sad-lang-dev/

المساهمة

اقرأ دليل المساهمة. باختصار: فرع agent/<مهمة> في worktree من dev → commit موقّع GPG → PR إلى dev (الدفع المباشر ممنوع).

الرخصة

MIT — كالمشروع الأمّ.