Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -76,7 +76,7 @@ Every symbol that appears in `equation` or `derivation` must be explained: eithe

Rules the checker enforces: the number of `variables` explanations, `## Derivation` notes and chart labels must match `lesson.yaml`; every `$…$` segment in a translation must be identical to the English one (translate the words, never the maths); no LaTeX outside `$…$`.

Arabic text follows `content/lessons/STYLE.ar.md`.
Write for a student meeting the concept for the first time. Follow [the English teaching guide](content/lessons/STYLE.en.md) and [the Arabic writing guide](content/lessons/STYLE.ar.md). Review each language as an explanation in its own right, and check every example against the lesson configuration and visualization. Passing the content validator does not establish teaching quality.

### Real-life examples and challenges

Expand Down
119 changes: 57 additions & 62 deletions content/lessons/STYLE.ar.md
Original file line number Diff line number Diff line change
@@ -1,62 +1,57 @@
# دليل الأسلوب العربي — Visualize It

الهدف: نص يكتبه معلم عربي يشرح لطلابه، لا ترجمة لنص إنجليزي. القارئ غير متخصص، غالبًا طالب ثانوي أو جامعي.

## القاعدة الأولى: اكتب من جديد، لا تترجم
اقرأ الفقرة الإنجليزية لتفهم *الفكرة* ثم اكتبها كما تقولها لطالب أمامك. لا يلزم أن تتطابق الجمل واحدة بواحدة؛ يلزم أن تتطابق الأفكار وعدد الفقرات، وأن تبقى الصيغ الرياضية `$…$` كما هي حرفيًا (يتحقق `npm run check` من ذلك).

## ما يجعل النص ركيكًا (تجنبه)
- الجملة الاسمية الطويلة المنقولة عن الإنجليزية: «القيمة المتوقعة هي الرقم الذي…» ← ابدأ بالفعل: «تخبرك القيمة المتوقعة…».
- المبني للمجهول المتكرر («يُحسب»، «يُعرض») حيث يمكن الفاعل: «نحسب»، «ترى».
- الشرطة الطويلة والفاصلة المنقوطة والنقطتان الرأسيتان: استبدلها بجمل قصيرة أو بـ«أي» و«فـ».
- «انظر إلى»، «شاهد»، «لاحظ» في كل فقرة. مرة واحدة تكفي، ثم خاطب القارئ مباشرة: «حرّك المنزلق، يزداد…».
- التشكيل الزائد. ضع الشدة والحركة فقط حيث يلتبس المعنى (عُدّ، حُلّ). لا تشكيل على الكلمات الشائعة.
- النقل الحرفي للتعابير الإنجليزية («يلعب دورًا»، «في نهاية اليوم»).
- أخطاء العدد والمعدود (ثلاث محاولات، عشرة دروس، 12 درسًا) والتذكير والتأنيث.
- الأرقام: أرقام غربية 0-9 دائمًا، والوحدات اللاتينية كما هي (m/s, kPa).

## الوضوح قبل كل شيء (أهم قاعدة)
نص سليم لغويًا لكنه مجرد لا يفيد أحدًا. القارئ طفل في الثانية عشرة أو شخص لم يدرس المادة. هذه القواعد تنطبق على العربية والإنجليزية معًا:
1. **ابدأ بموقف من الحياة بأرقام حقيقية** قبل أي رمز: «معك 20 ريالًا، اشتريت 3 دفاتر وبقي معك 5…». الرمز يأتي بعد أن يفهم القارئ الموقف.
2. **سمِّ ما يراه على الشاشة**: «الخط الأزرق»، «النقطة البرتقالية»، «المنزلق الأول». لا تقل «المنحنى» وهو لا يعرف أي منحنى.
3. **صيغة واحدة في الجملة على الأكثر**. لا تبدأ الجملة بصيغة ولا تنهها بها، ولا تضع صيغتين متجاورتين.
4. **اشرح كل رمز بكلمات عند أول ظهوره**: «$m$، أي كم يصعد الخط في كل خطوة».
5. **لا عبارات خبراء** في الملخص وفقرات «الفكرة»: «حالة منحطّة»، «نظام متوافق»، «بدلالة»، «تقارب»، «معرّف على». ضعها في «المتقدم» فقط.
6. **الملخص** جملة واحدة بلا صيغ، تجيب: لماذا أحتاج هذا؟
7. **العنوان يطابق الرسم**. إن كان الرسم خطًّا واحدًا فلا تقل «أين يلتقي خطان».
8. **الاختبار**: هل يستطيع طالب في الصف السادس أن يعيد الفكرة بكلماته بعد قراءتها مرة؟ إن لم يستطع فأعد الكتابة.

تعابير مترجمة حرفيًا ممنوعة: «ليس أكثر من» (nothing more than)، «هو تمامًا نفس» (exactly the same)، «نفس الشيء» ← «الشيء نفسه»، «بدلالة» (in terms of)، «يلعب دورًا»، «من حيث»، «فيما يتعلق بـ».

ركيك ومجرد: «حل $mx + b = k$ ليس أكثر من تحريك $x$ حتى تصل هذه القيمة إلى الصفر، لأن الخط الذي تسحب عليه هو $y = mx + b - k$.»
واضح: «معك 20 ريالًا. اشتريت دفاتر بـ 3 ريالات للواحد، فبقي معك 5. كم دفترًا اشتريت؟ هذا سؤال المعادلة الخطية: ما العدد الذي يجعل الطرفين متساويين؟ اسحب النقطة البرتقالية على الخط الأزرق. حين يقطع الخط المحور الأفقي يصبح الفرق بين الطرفين صفرًا، وهناك الجواب.»

## أخطاء تكررت فعلًا في هذا المشروع (صاحب المشروع رفضها)
هذه جمل حقيقية من الموقع. كلها مفهومة نحويًا لكنها ترجمة حرفية لاستعارات إنجليزية، والقارئ العربي لا يقولها:

| ركيك (ترجمة حرفية) | الصواب |
| --- | --- |
| «تجعل الأداة تحطّ عند 10» (land on) | «حتى يقف المؤشر على 10» |
| «لا يكلّف أكثر من ضربة والتفافة واحدة» | «يكفي ضرب واحد ثم أخذ الباقي» |
| «رخيص البناء خطوة تلو الأخرى» (cheap to build) | «سهل أن تبنيه خطوة بعد خطوة» |
| «رفع عدد إلى قوة على وجه ساعة» (on a clock face) | «ترفع عددًا إلى قوة على دائرة أرقام» |
| «تسرد الأداة» / «تعرض الأداة» | «تظهر على الدائرة» أو «يعرض الرسم» |
| «حساب يتصرف بهذه الطريقة» (behaves this way) | «عملية حسابية بهذه الصفة» |
| «أن تُعطى فقط الرقم الأخير» | «أن تعرف الرقم الأخير وحده» |

قواعد إضافية:
- سمِّ ما على الشاشة باسمه العربي: الدائرة، الرسم، المنزلق، النقطة، الخط. لا تقل «الأداة» ولا «الودجت».
- استخدم أفعالًا عربية شائعة: يقف، يستقر، يتحرك، يزيد، ينقص، نضرب، نقسم. تجنّب الأفعال المترجمة حرفيًا.
- الجملة 18 كلمة على الأكثر، وفكرة واحدة فيها، وابدأها بالفعل حيثما أمكن.
- الاختبار الأخير: اقرأ الفقرة بصوت عالٍ وتخيّل أنك تقولها لصديق. إن كنت لن تقولها هكذا، فأعد كتابتها.

## المصطلحات المعتمدة
المشتقة، التكامل، النهاية، الميل، المتوسط، التباين، الانحراف المعياري، التوافيق، التباديل، التوزيع ذو الحدين، توزيع بواسون، التوزيع الطبيعي، الاحتمال الشرطي، القيمة المتوقعة، قوة الرفع، قوة السحب، زاوية الهجوم، الانهيار الهوائي (stall)، الجهد، التيار، المقاومة، السعة، الحث، الرنين، المتجه، التدرج، المستوى المماس، الخوارزمية، التعقيد الحسابي، البوابة المنطقية، الوباء، تردد الأليل، الإنزيم والركيزة.
اكتب المصطلح الإنجليزي بين قوسين عند أول ظهوره إذا كان الطالب سيصادفه بالإنجليزية.

## الطول والإيقاع
جمل من 8 إلى 18 كلمة. فقرة من 3 إلى 5 جمل. فكرة واحدة لكل جملة. اقرأ الفقرة بصوت عالٍ؛ إن تعثر اللسان فأعد كتابتها.

## مثال
ركيك: «القيمة المتوقعة هي النتيجة المتوسطة على مدى تكرارات كثيرة، وهي الرقم الذي يخبرك ما إذا كانت اللعبة تستحق.»
أفضل: «كرر اللعبة مرات كثيرة واحسب متوسط ما ربحته في المرة الواحدة. هذا المتوسط هو القيمة المتوقعة، وهو ما يقرر إن كانت اللعبة تستحق أن تُلعب.»
# كتابة الدروس بالعربية

نكتب بفصحى سهلة، كما يشرح معلم لطالب يسمع الفكرة للمرة الأولى. لا نفترض أن الطالب يعرف المصطلح لمجرد أنه يعرف قراءة الكلمة. الهدف أن يفهم السبب، لا أن يحفظ وصفًا للرسم.

## قبل الكتابة

اقرأ `lesson.yaml` وافحص الرسم الذي يستخدمه الدرس. جرّب القيم المذكورة في الشرح، وتأكد من أن خطوات التدريب تطابق ما يظهر فعلًا. راجع شروط التحديات أيضًا؛ فقد يطلب النص شيئًا مختلفًا عما يقبله البرنامج.

افهم الفكرة من المصدر الإنجليزي، ثم اكتب الشرح بالعربية من جديد. لا تنقل ترتيب الكلمات أو الاستعارات. يجوز استخدام مثال محلي، بشرط أن يشرح الفكرة نفسها وأن يطابق قيم المثال المحفوظ.

## كيف نبني الشرح؟

1. ابدأ بسؤال واضح أو مثال صغير يستطيع الطالب تتبعه. استخدم موقفًا يوميًا إذا كان مناسبًا؛ لا تخترع قصة لمجرد افتتاح الدرس.
2. اشرح الفكرة قبل تسميتها. مثلًا: «قيمة الرقم تتحدد بمكانه في العدد. نسمي هذا القيمة المكانية».
3. اربط المثال بالرسم. سمّ الخط أو النقطة أو الخانة، واشرح ماذا يمثل كل منها.
4. أعطِ الطالب تغييرًا واحدًا ليجربه، واذكر ما يبقى ثابتًا. ثم وضّح النتيجة وسببها.
5. قدّم الرموز بعد المعنى. اشرح ما يمثله الرمز، ووحدته إن كانت له وحدة.
6. انتقل إلى القاعدة في قسم Formal. لا تضع معادلة وحدها وتتوقع أن تشرح نفسها.
7. اذكر حدود المثال عند الحاجة. ميل المماس يعطي تغيرًا تقريبيًا قرب النقطة، وليس تغيرًا دقيقًا على أي مسافة.

## لغة طبيعية

- استخدم جملًا واضحة، وفكرة أساسية واحدة في كل جملة. قسّم الجملة حين يضيع معناها، لا عند عدد ثابت من الكلمات.
- استخدم المصطلح العربي الصحيح، ثم فسّره. «البسط» أنفع من الاكتفاء بعبارة «الرقم العلوي» إذا شرحت أنه عدد الأجزاء المأخوذة.
- اكتب الأعداد بأرقام 0–9، وحافظ على الوحدات والرموز. لا تعكس ترتيب الإشارة السالبة يدويًا؛ اكتب -3، لا 3-.
- تجنب الطمأنة التي تقلل من صعوبة التعلم: «الأمر بسيط جدًا»، «لا شيء أصعب من ذلك»، «من الواضح».
- تجنب وصف الرسم كأنه إنسان: المؤشر لا «يمشي»، والخط لا «يقرر». قل ما يتغير مباشرة.
- استخدم علامات الترقيم لخدمة المعنى. لا حظر عام على النقطتين أو الجملة الاسمية أو المبني للمجهول.
- لا تستبدل الكلمات آليًا بقائمة مرادفات. سلامة العبارة تعتمد على سياقها.
- أضف التشكيل عند احتمال الالتباس فقط. واستخدم المصطلح الإنجليزي إذا كان سيساعد الطالب، لا لمجرد الزينة.

## أمثلة على المراجعة

| قبل | بعد | سبب التغيير |
| --------------------------------------------------- | ------------------------------------------------------------------------------------ | ------------------------------------------ |
| «347 و743 عالمان مختلفان تمامًا» | «في 347 تعني الـ3 ثلاث مئات، وفي 743 تعني ثلاث آحاد» | يشرح الفرق بدل المبالغة فيه. |
| «يُدفئ صباحًا بدرجة -3 مقدار 10 درجات» | «تبدأ درجة الحرارة عند -3°C وترتفع 10 درجات، فتصل إلى 7°C» | يحدد البداية والتغير والنتيجة. |
| «عدّ شرائح أخذتها من عدد قطعات، لا شيء أصعب من ذلك» | «المقام يخبرنا إلى كم جزء متساوٍ قسّمنا الواحد الصحيح، والبسط يخبرنا كم جزءًا أخذنا» | يعرّف المعنى دون التقليل من صعوبة الفكرة. |
| «عند أدنى نقطة، فلا صعود إطلاقًا» | «الميل عند هذه النقطة صفر، رغم أن المسار يرتفع على جانبيها» | يميز الميل عند النقطة عن شكل المسار حولها. |

## وظيفة كل قسم

- **الملخص:** جملة قصيرة تحدد ما سيتعلمه الطالب، دون مبالغة أو مصطلحات غير مشروحة.
- **Try it:** خطوات قابلة للتنفيذ بقيم محددة ونتائج يمكن ملاحظتها. لا تدّعِ حركة أو لونًا لم تتحقق منهما.
- **Intuition:** شرح متدرج يجيب عن «لماذا؟»، وليس تكرارًا لتعليمات المنزلقات.
- **Formal:** القاعدة الدقيقة، مع تعريف الرموز والشروط اللازمة.
- **Advanced:** تفاصيل أعمق يستطيع المبتدئ تجاوزها دون أن يفقد الفكرة الأساسية.
- **Derivation:** اشرح سبب الانتقال بين الخطوات، لا تكتفِ بتسمية العملية.
- **الأمثلة والتحديات:** طابق ترتيبها وقيمها مع `lesson.yaml`. لا تطلب في النص شرطًا لا يفحصه التحدي.

## المراجعة قبل النشر

اقرأ النص بصوت عالٍ. هل يمكنك قوله لطالب دون إعادة صياغته؟ ثم تحقق من أن الطالب يستطيع شرح الفكرة، وتنفيذ الخطوات، وتوقع نتيجة تغيير بسيط.

راجع الحسابات والوحدات، ولا تنقل خطأ من الإنجليزية بحجة الحفاظ على الترجمة. أصلح اللغتين معًا عند وجود خطأ مشترك.

حافظ على عناوين الأقسام الإنجليزية لأنها مفاتيح يقرأها البرنامج. يتحقق `pnpm check` من تطابق عدد فقرات Intuition وFormal بين اللغتين، ومن تطابق الصيغ `$…$` في الملخص وهذين القسمين وخطوات الاشتقاق. عدّل النسختين معًا عند إعادة تنظيمهما. نجاح الفحص يثبت سلامة البنية، ولا يثبت جودة الشرح.
Loading
Loading