From 91c111a42e4c3e6e91016f6ef823b5459e1a48b4 Mon Sep 17 00:00:00 2001 From: ru44 <18311071+ru44@users.noreply.github.com> Date: Mon, 16 Nov 2026 09:30:49 +0300 Subject: [PATCH 1/6] content: explain place value clearly in Arabic and English --- content/lessons/numbers/place-value/ar.md | 52 +++++++++++---------- content/lessons/numbers/place-value/en.md | 55 ++++++++++++----------- 2 files changed, 57 insertions(+), 50 deletions(-) diff --git a/content/lessons/numbers/place-value/ar.md b/content/lessons/numbers/place-value/ar.md index 86d63464..3a5882b2 100644 --- a/content/lessons/numbers/place-value/ar.md +++ b/content/lessons/numbers/place-value/ar.md @@ -1,58 +1,62 @@ --- title: القيمة المكانية -summary: >- - 347 قطعة حلوى تختلف كثيرًا عن 743، مع أن الأرقام نفسها. مكان الرقم يحدد قيمته. +summary: لماذا تعني الـ3 في العدد 347 ثلاث مئات، بينما تعني في العدد 743 ثلاث آحاد؟ parameters: N: العدد N --- ## Try it -1. حرّك المنزلق N فوق 9. تلتحم عشرة مربعات تركوازية صغيرة، كل واحد منها قطعة حلوى، في قضيب أزرق واحد بعمود العشرات. -2. ادفع N فوق 99. راقب ظهور صفيحة مئة برتقالية: ورقة مسطحة كاملة تساوي مئة قطعة حلوى دفعة واحدة. -3. اجعل N قريبًا من 9999، وراقب مكعبات الألف الحمراء تتكدس في العمود الأول. كل مكعب منها يساوي ألف قطعة حلوى. +1. اضبط N على 9، ثم على 10. تختفي المربعات الصغيرة التسعة ويظهر عمود واحد يمثل عشرة آحاد. +2. قارن بين 99 و100. عند 100، تخلو خانتا العشرات والآحاد، ويظهر مربع كبير يمثل مئة واحدة. +3. قارن بين 347 و743. تبقى خانة العشرات كما هي. ماذا يتغير في خانتي المئات والآحاد؟ ## Real-life examples -1. **حلوى في كيس.** تنقسم 124 قطعة حلوى إلى مئة واحدة وعشرتين وأربع آحاد، فيسهل عدّها بسرعة. -2. **مقاعد ممتلئة في ملعب صغير.** يضم الملعب 2530 مقعدًا: ألفين وخمس مئات وثلاث عشرات وصفر آحاد. -3. **حبوب أرز في قدر طبخ.** تحوي قدر الطبخ نحو 8000 حبة أرز: ثمانية آلاف كاملة، بلا بقية أصغر. +1. **ترتيب 124 قلمًا.** يمكنك جمع مئة قلم في مجموعة، وعشرين في مجموعتين من عشرة، وتبقى 4 أقلام. +2. **عدّ 2530 مقعدًا.** يتكون العدد من ألفين وخمس مئات وثلاث عشرات. الصفر يعني عدم وجود آحاد إضافية. +3. **عدّ 8000 تذكرة.** لديك 8 رزم، في كل منها ألف تذكرة. لذلك تكون أرقام المئات والعشرات والآحاد أصفارًا. ## Test yourself -1. اجعل N يساوي 1000 بالضبط، عددًا مدوّرًا. -2. اجعل رقم المئات في N يساوي 5. -3. ارفع N فوق 9000 وأبقه تحت 9500. +1. اضبط N على 1000. في أي خانة يظهر الشكل؟ +2. اختر عددًا فيه 5 في خانة المئات. +3. اختر عددًا أكبر من 9000 وأصغر من 9500. ## Intuition -تخيّل 347 قطعة حلوى، مبنية على الشاشة من مكعبات: مربع تركوازي صغير لكل قطعة حلوى واحدة، وقضيب أزرق لكل حزمة من عشر قطع، وصفيحة برتقالية لكل مئة قطعة، ومكعب أحمر غامق لكل ألف كامل. حرّك المنزلق N، وراقب عشرة مربعات تركوازية صغيرة في عمود الآحاد تلتحم فجأة في قضيب أزرق واحد بمجرد أن يتجاوز N مضاعفًا للعشرة. +لديك 347 قلمًا. يمكنك تقسيمها إلى 3 مجموعات من مئة، و4 مجموعات من عشرة، و7 أقلام منفردة. الرقم 3 هنا يعني ثلاث مئات، أي 300 قلم. هذه هي القيمة المكانية: قيمة الرقم تتحدد بمكانه في العدد. -لهذا فإن 347 قطعة حلوى و743 قطعة حلوى عالمان مختلفان تمامًا، رغم أن العددين يستخدمان الأرقام الثلاثة نفسها. بدّل الرقم الأول بالأخير، وتستبدل سبع مئات من الحلوى بثلاث مئات فقط. الفرق أربع مئات قطعة، من تحريك رقمين لا أكثر. +يمثل الرسم هذه المجموعات بأشكال مختلفة. المربع الصغير يمثل واحدًا، والعمود يمثل عشرة، والمربع الكبير يمثل مئة. أما الشكل في خانة الآلاف فيمثل ألفًا. كل عشرة من مجموعة تساوي واحدًا من المجموعة التالية إلى اليسار. + +قارن الآن بين 347 و743. في العدد 743، تعني الـ7 سبع مئات، وتعني الـ3 ثلاث آحاد. الأرقام نفسها، لكن قيمها تغيرت. زاد العدد بمقدار 396، لأن المئات زادت 400 والآحاد نقصت 4. ## Formal -في النظام العشري، يُكتب العدد الصحيح كصف من الأرقام، وكل منزلة تمثّل قوة من قوى العشرة: آحاد ثم عشرات ثم مئات ثم آلاف وهكذا. والرقم نفسه (من 0 إلى 9) يخبرك كم مرة تأخذ تلك القوة. +نستخدم في النظام العشري عشرة أرقام، من 0 إلى 9. نبدأ من اليمين بالآحاد، ثم العشرات، ثم المئات، ثم الآلاف. قيمة كل منزلة تساوي عشرة أمثال قيمة المنزلة التي تسبقها إلى اليمين. -فـ $347 = 3\times10^{2} + 4\times10^{1} + 7\times10^{0}$: ثلاث مئات وأربع عشرات وسبعة آحاد، مجموعة معًا. +نكتب مثلًا $347 = 3\times10^{2} + 4\times10^{1} + 7\times10^{0}$. قوى العشرة هنا تعني 100 و10 و1. نجمع قيمة كل رقم لنحصل على العدد كاملًا. ## Advanced -أي أساس $b$ يعمل بالطريقة نفسها. الأرقام تتراوح من $0$ إلى $b-1$، والمنزلة $i$ تمثّل $b^{i}$. والنظام الثنائي (أساسه اثنان) والنظام الست عشري (أساسه ستة عشر) نظاما قيمة مكانية أيضًا، فالحاسوب يستخدم $b=2$ بدل $b=10$ فقط. +تعمل أنظمة العد الأخرى بالفكرة نفسها. في نظام أساسه $b$، نستخدم الأرقام من $0$ إلى $b-1$. نرقّم المنازل بدءًا من الصفر على اليمين، فتكون قيمة المنزلة $i$ هي $b^{i}$. يستخدم النظام الثنائي $b=2$، ويستخدم النظام العشري $b=10$. ## Derivation -1. اقسم 347 إلى جزء مئات وجزء عشرات وجزء آحاد: 300 و40 و7. -2. اكتب كل جزء كرقم مضروب في عدد مدوّر: 3 مئات و4 عشرات و7 آحاد. -3. استبدل كل عدد مدوّر بقوة من قوى العشرة، لأن $100 = 10^2$ و$10 = 10^1$. +1. نفصل 347 إلى 300 و40 و7. مجموع هذه الأجزاء يساوي العدد الأصلي. +2. نكتب 300 على صورة 3 مضروبة في 100، و40 على صورة 4 مضروبة في 10. أما 7 فتمثل الآحاد. +3. نختصر كتابة قيم المنازل باستخدام قوى العشرة، حيث $100 = 10^2$ و$10 = 10^1$. ## Real world ### النقود -تسير الأسعار بالطريقة نفسها: 3.47 دولارات تعني 3 وحدات كاملة و4 أعشار و7 أجزاء من مئة، قيمة مكانية بقوى أصغر من واحد. -### عدّاد السيارة -تدور عجلة الآحاد في عدّاد السيارة أسرع من غيرها، وكل دورة كاملة لها تدفع عجلة العشرات رقمًا واحدًا، تمامًا كالحمل في القيمة المكانية. +المبلغ 3.47 ريال يتكون من 3 ريالات، و4 أعشار الريال، و7 أجزاء من مئة. تمتد القيمة المكانية إلى يمين الفاصلة أيضًا. + +### العدّ بعد التسعة + +عندما ينتقل العداد من 9 إلى 10، يعود رقم الآحاد إلى الصفر ويزيد رقم العشرات واحدًا. العدد زاد واحدًا، والآحاد السابقة أصبحت عشرة واحدة. + +### تخزين الأعداد في الحاسوب -### ذاكرة الحاسوب -يخزّن الحاسوب كل عدد في أعمدة قيمة مكانية أيضًا، لكن بأساس اثنين بدل عشرة، وهذا ما تعنيه منزلة «البت» الواحدة. +الخانة الثنائية، أو البت، تحمل 0 أو 1 فقط. قيم المنازل في العدد الثنائي الصحيح هي 1 ثم 2 ثم 4 ثم 8، وهكذا. diff --git a/content/lessons/numbers/place-value/en.md b/content/lessons/numbers/place-value/en.md index c8db6034..45b63f24 100644 --- a/content/lessons/numbers/place-value/en.md +++ b/content/lessons/numbers/place-value/en.md @@ -1,59 +1,62 @@ --- title: Place value -summary: >- - Learn why 347 sweets and 743 sweets are worlds apart, even though both use - the very same three digits. +summary: Find out why the 3 in 347 means 300, while the 3 in 743 means just 3. parameters: - N: the number N + N: number N --- ## Try it -1. Drag the slider labelled N up past 9. A teal square, one for each sweet, snaps together into a single blue rod in the tens column — ten sweets bundled as one ten. -2. Push N past 99. Watch an orange hundred-square appear: a whole flat sheet worth a hundred sweets at once. -3. Set N close to 9999, and count the red thousand-cubes stacking up in the first column — each one is worth a thousand sweets. +1. Set N to 9, then to 10. Nine small squares are replaced by one rod. Each rod represents ten ones. +2. Compare 99 and 100. At 100, the tens and ones columns are empty and one hundred-square appears. +3. Compare 347 and 743. The tens column stays the same. What changes in the hundreds and ones columns? ## Real-life examples -1. **Sweets in a bag.** 124 sweets split into 1 hundred, 2 tens and 4 ones — easy to count fast. -2. **Seats filled in a small stadium.** 2530 seats: 2 thousands, 5 hundreds, 3 tens and 0 ones. -3. **Rice in a cooking pot.** About 8000 grains of rice: 8 whole thousands, no smaller piles left over. +1. **Packing 124 pencils.** You can make one group of 100 and two groups of 10, with 4 pencils left. +2. **Counting 2530 seats.** The number contains 2 thousands, 5 hundreds and 3 tens. The zero tells us there are no extra ones. +3. **Counting 8000 tickets.** Eight packs of 1000 tickets make 8000. The hundreds, tens and ones digits are all zero. ## Test yourself -1. Set N to exactly 1000, a nice round thousand. -2. Make the hundreds digit of N equal to 5. -3. Push N above 9000 but keep it under 9500. +1. Set N to 1000. Which column contains a block? +2. Choose a number with 5 in the hundreds place. +3. Choose a number greater than 9000 and less than 9500. ## Intuition -Picture 347 sweets, stacked as building blocks on screen: a small teal square for each single sweet, a blue rod for every bundle of ten, an orange sheet for every hundred, and a deep red cube for every full thousand. Drag the slider N, and watch ten small teal squares in the ones column snap together into one blue rod the moment N passes a multiple of ten. +Suppose you have 347 pencils. You can group them into 3 hundreds, 4 tens and 7 ones. The digit 3 tells you how many hundreds there are, so it contributes 300 to the total. This is place value: a digit's position tells you what it is worth. -This is why 347 sweets and 743 sweets are worlds apart, even though both numbers use the very same three digits. Swap the first digit with the last, and you trade seven hundred sweets for only three hundred — a jump of four hundred sweets, just from moving two digits around. +The blocks show these groups. A small square represents one, a rod represents ten, and a large square represents one hundred. A block in the thousands column represents one thousand. Ten of any one group have the same value as one group in the next column to the left. + +Now compare 347 and 743. In 743, the 7 means 700 and the 3 means 3. The digits are the same, but their values have changed. The total increases by 396: the hundreds add 400, while the ones decrease by 4. ## Formal -In base ten, a whole number is written as a row of digits, and each position stands for a power of ten: ones, tens, hundreds, thousands, and so on. The digit itself (0–9) says how many of that power of ten to take. +Our decimal system uses ten digits, from 0 to 9. Starting on the right, the places represent ones, tens, hundreds and thousands. Each place is worth ten times the place immediately to its right. -So $347 = 3\times10^{2} + 4\times10^{1} + 7\times10^{0}$: three hundreds, four tens and seven ones, added together. +For example, $347 = 3\times10^{2} + 4\times10^{1} + 7\times10^{0}$. Here the powers of ten mean 100, 10 and 1. Adding the three contributions gives the whole number. ## Advanced -Any base $b$ works the same way: digits run from $0$ to $b-1$, and position $i$ stands for $b^{i}$. Binary (base two) and hexadecimal (base sixteen) are place-value systems too — computers just use $b=2$ instead of $b=10$. +Other bases use the same principle. In base $b$, the digits range from $0$ to $b-1$. Counting places from zero on the right, place $i$ has value $b^{i}$. Binary uses $b=2$, while decimal uses $b=10$. ## Derivation -1. Split 347 into a hundreds part, a tens part and a ones part: 300, 40 and 7. -2. Write each part as a digit times a round number: 3 hundreds, 4 tens, 7 ones. -3. Replace each round number with a power of ten, since $100 = 10^2$ and $10 = 10^1$. +1. Separate 347 into 300, 40 and 7. Adding these parts gives the original number. +2. Write 300 as 3 times 100, and 40 as 4 times 10. The 7 counts individual ones. +3. Use powers of ten to write the place values more compactly: $100 = 10^2$ and $10 = 10^1$. ## Real world ### Money -Prices work the same way: a cost of 3.47 dollars is 3 whole units, 4 tenths and 7 hundredths — place value with powers smaller than one. -### Odometers -A car's odometer wheel for the ones place spins fastest; each full turn nudges the tens wheel by one digit, exactly like carrying in place value. +An amount of 3.47 has 3 whole currency units, 4 tenths and 7 hundredths. Place value also works to the right of the decimal point. + +### Counting beyond nine + +When a counter goes from 9 to 10, the ones digit returns to zero and the tens digit increases by one. You have counted one more item, not lost the previous nine. + +### Computer storage -### Computer memory -Computers store every number in place-value columns too, just with base two instead of base ten — that's what a "bit" position means. +A binary digit, called a bit, is either 0 or 1. In a binary whole number, the places are worth 1, 2, 4, 8 and so on. From d137e59278aeacf025c1c4a1eeefc3b5a3e547a3 Mon Sep 17 00:00:00 2001 From: ru44 <18311071+ru44@users.noreply.github.com> Date: Mon, 16 Nov 2026 09:30:49 +0300 Subject: [PATCH 2/6] content: teach negative numbers through temperature changes --- .../lessons/numbers/negative-numbers/ar.md | 65 ++++++++++--------- .../lessons/numbers/negative-numbers/en.md | 64 +++++++++--------- 2 files changed, 65 insertions(+), 64 deletions(-) diff --git a/content/lessons/numbers/negative-numbers/ar.md b/content/lessons/numbers/negative-numbers/ar.md index ef329a58..af2932b8 100644 --- a/content/lessons/numbers/negative-numbers/ar.md +++ b/content/lessons/numbers/negative-numbers/ar.md @@ -1,66 +1,67 @@ --- title: الأعداد السالبة -summary: >- - حرارة تهبط تحت الصفر على ميزان حرارة وخط أعداد. لماذا −7 أبرد من −3؟ +summary: افهم الأعداد السالبة وجمعها من خلال ارتفاع درجة الحرارة وانخفاضها. parameters: - T1: درجة الحرارة الابتدائية T1 (°م) - dT: التغيّر في درجة الحرارة ΔT (°م) + T1: درجة الحرارة في البداية T1 (°C) + dT: التغير في درجة الحرارة ΔT (°C) variables: - - درجة الحرارة الابتدائية، قبل التغيّر - - التغيّر في درجة الحرارة، موجب للدفء وسالب للبرودة - - درجة الحرارة النهائية، بعد التغيّر + - درجة الحرارة قبل التغير + - التغير في درجة الحرارة؛ موجب عند الارتفاع وسالب عند الانخفاض + - درجة الحرارة بعد التغير --- ## Try it -1. اضبط «T1» على 5 و«dT» على -12. يهبط عمود الزئبق تحت الصفر ويقف عند -7. يشير سهم خط الأعداد إلى اليسار أيضًا. -2. أبقِ «dT» عند -12، وارفع «T1» إلى 20. الهبوط نفسه بمقدار 12 درجة، لكنه يستقر الآن فوق الصفر بكثير. تصل الحرارة إلى 8. -3. اضبط «T1» على 0، واسحب «dT» إلى -25. يغوص المؤشر بعيدًا تحت خط التجمد. يصل إلى -25، قراءة باردة حقًا. +1. اضبط T1 على 5 وdT على -12. تصبح درجة الحرارة -7. تتبع السهم من 5 إلى -7 على خط الأعداد. +2. أبقِ dT عند -12 واضبط T1 على 20. تنخفض الحرارة 12 درجة أيضًا، لكنها تصل هذه المرة إلى 8. +3. اضبط T1 على -3 وdT على 10. ترتفع الحرارة وتتجاوز الصفر لتصل إلى 7. ## Real-life examples -1. **صقيع ليلي (T1 = 5، dT = -12).** يبرد صباح بدرجة 5 مقدار 12 درجة خلال الليل. ينتهي عند -7، تحت التجمد. -2. **وصول كتلة هوائية دافئة (T1 = -3، dT = 10).** يدفأ صباح بدرجة -3 مقدار 10 درجات. ينتهي عند 7، فوق التجمد. -3. **موجة برد (T1 = 0، dT = -25).** تضرب جبهة باردة بقوة 25 درجة يومًا عند نقطة التجمد. ينتهي ذلك اليوم عند -25. +1. **ليلة باردة.** تبدأ درجة الحرارة عند 5°C وتنخفض 12 درجة، فتصل إلى -7°C. +2. **صباح أدفأ.** تبدأ درجة الحرارة عند -3°C وترتفع 10 درجات، فتصل إلى 7°C. +3. **انخفاض كبير في الحرارة.** تبدأ درجة الحرارة عند 0°C. إذا انخفضت 25 درجة، تصل إلى -25°C. ## Test yourself -1. جد درجة ابتدائية وتغيّرًا يستقران تمامًا عند 0، خط التجمد. -2. جد توليفة تنتهي تحت -20 درجة. -3. جد توليفة تنتهي فوق 30 درجة. +1. اختر درجة حرارة ابتدائية وتغيرًا يجعل درجة الحرارة النهائية 0°C. +2. اجعل درجة الحرارة النهائية أقل من -20°C. +3. اجعل درجة الحرارة النهائية أعلى من 30°C. ## Intuition -مقياس الحرارة خط أعداد واقف. الصفر يمثّل التجمد، والأرقام فوقه أدفأ، والأرقام تحته أبرد. كلما هبطت تحت الصفر أكثر، كان الجو أبرد. حرّك «T1» على الشاشة لتحديد أين تبدأ القراءة. ثم حرّك «dT» لإضافة تغيّر. «dT» الموجب يرفع المؤشر، والسالب يخفضه، وقد يعبر الصفر إن كان التغيّر كبيرًا بما يكفي. +إذا كانت درجة الحرارة 5°C ثم انخفضت 5 درجات، فإنها تصل إلى الصفر. وإذا انخفضت 7 درجات أخرى، تصبح -7°C، ونقرأها «سبع درجات تحت الصفر». تخبرنا إشارة السالب أن القراءة تقع تحت الصفر. -إضافة عدد سالب هي هذا الانزلاق نحو اليسار بالضبط. ابدأ من 5 وأضف -12، فهذه ليست قاعدة خاصة تُحفظ. إنه السهم نفسه الذي تستخدمه لأي جمع، تحرك يمينًا للموجب وتحرك يسارًا للسالب. لكنه هذه المرة يعبر الصفر في طريقه. تستقر عند -7، وهي أبعد يسارًا من 0 ومن -3 أيضًا. لذلك -7 هي الأبرد بين الثلاثة، رغم أن 7 وحدها تبدو الرقم «الأكبر». +على خط الأعداد، تزيد القيم كلما اتجهنا يمينًا، وتنقص كلما اتجهنا يسارًا. لجمع -12 مع 5، نتحرك 12 وحدة إلى اليسار. نصل إلى الصفر بعد 5 وحدات، ثم نكمل 7 وحدات فنصل إلى -7. لذلك تعطي إضافة -12 النتيجة نفسها التي يعطيها طرح 12. + +قارن موضعي -7 و-3 على الخط. يقع -7 إلى يسار -3، ولذلك هو الأصغر. ولهذا تكون درجة الحرارة -7°C أبرد من -3°C. صحيح أن 7 أكبر من 3، لكننا هنا نقارن عددين سالبين. ## Formal -إضافة تغيّر إشاري $\Delta T$ إلى قيمة ابتدائية $T_1$ تعطي $T_2 = T_1 + \Delta T$، حيث $\Delta T$ السالب يُحرّك $T_2$ إلى يسار $T_1$ على خط الأعداد بذلك العدد من الوحدات. +نرمز للتغير في درجة الحرارة بالرمز $\Delta T$، ولدرجة الحرارة الابتدائية بالرمز $T_1$. نحسب الدرجة النهائية بالعلاقة $T_2 = T_1 + \Delta T$. التغير الموجب يرفع درجة الحرارة، والتغير السالب يخفضها. -لأي عددين على الخط، الأبعد يسارًا هو الأصغر: $-7 < -3 < 0 < 7$، بغض النظر عن عدد الأرقام في كل عدد. +تزداد الأعداد على خط الأعداد من اليسار إلى اليمين. مثلًا، $-7 < -3 < 0 < 7$. نقرأ الرمز < بمعنى «أصغر من». ## Advanced -المسافة عن الصفر (المقدار) والموضع بالنسبة للصفر (الإشارة) قطعتا معلومات منفصلتان يحملهما عدد إشاري واحد. ومقارنة عددين سالبين بالحجم تعني مقارنة مقداريهما ثم عكس الترتيب، وهذا بالضبط سبب كون -7 أصغر من -3 رغم أن 7 أكبر من 3. +القيمة المطلقة للعدد هي بُعده عن الصفر دون النظر إلى إشارته. القيمة المطلقة لكل من -7 و7 تساوي 7. عند مقارنة عددين سالبين، يكون الأبعد عن الصفر هو الأصغر، لأنه يقع إلى اليسار. ## Derivation -1. ابدأ من 5 وأضف تغيّرًا قدره -12. -2. إضافة -12 مثل طرح 12 تمامًا. -3. 5 ناقص 12 يترك -7. +1. نبدأ من 5°C. الانخفاض بمقدار 12 درجة يعني تغيرًا قدره -12. +2. إضافة -12 تعطي النتيجة نفسها التي يعطيها طرح 12. +3. نطرح 5 فنصل إلى الصفر، ثم نطرح 7 المتبقية. النتيجة هي -7°C. ## Real world -### تقارير الطقس -الحد الأدنى الليلي وقراءات برودة الرياح غالبًا سالبة. توقّع بـ -7°م يعني 7 درجات تحت خط التجمد، لا «ناقصًا» بمعنى مجرد. +### درجة الحرارة + +القراءة -7°C تعني سبع درجات تحت 0°C. وجود إشارة السالب لا يعني انعدام الحرارة. + +### الديون -### أرصدة البنوك والديون -رصيد قدره -50 دولارًا يعني أنك مدين بخمسين دولارًا. الخط نفسه هنا: 0 يعني «لا شيء عليك»، والقيم السالبة تعني دينًا لا مدّخرات. +إذا سجلت المال الذي تملكه بالموجب والمال الذي تدين به بالسالب، تسجل دينًا قدره 50 بالعدد -50. بعد سداد 20، يصبح الدين المتبقي -30. -### الارتفاع -يقع وادي الموت عند نحو -86 مترًا، تحت مستوى سطح البحر (0). جبل عند 2000 متر ووادٍ عند -86 مترًا يُقارَنان على خط الأعداد الإشاري نفسه بالضبط. +### الارتفاع عن مستوى محدد -### الرياضة والألعاب -نتيجة غولف قدرها -4 (أربعة تحت المعدل) تتفوق على نتيجة +2، لأن الأقل أفضل في الغولف. إنه خط الأعداد نفسه، لكن يُقرأ بالاتجاه الذي يناسب اللعبة. +إذا اعتبرنا سطح البحر هو الصفر، فإن ارتفاع نقطة تحته بعشرة أمتار يساوي -10 أمتار. الإشارة السالبة تعني أن النقطة أسفل المستوى الذي اخترناه. diff --git a/content/lessons/numbers/negative-numbers/en.md b/content/lessons/numbers/negative-numbers/en.md index 2c05c020..39e4cdc5 100644 --- a/content/lessons/numbers/negative-numbers/en.md +++ b/content/lessons/numbers/negative-numbers/en.md @@ -1,67 +1,67 @@ --- title: Negative numbers -summary: >- - Watch a temperature fall below zero on a thermometer and a number line - together, and see why −7 is colder than 0, and colder still than −3. +summary: Use temperature changes to understand numbers below zero and how to add them. parameters: T1: starting temperature T1 (°C) - dT: change in temperature ΔT (°C) + dT: temperature change ΔT (°C) variables: - - the starting temperature, before the change - - the change in temperature — positive for warmer, negative for colder - - the final temperature, after the change + - temperature before the change + - temperature change; positive for a rise, negative for a fall + - temperature after the change --- ## Try it -1. Set T1 to 5 and dT to -12: the thermometer marker falls past zero, and the number line arrow points left, landing on -7. -2. Keep dT at -12 but raise T1 to 20: the same drop of 12 degrees now lands well above zero, at 8. -3. Set T1 to 0 and drag dT down to -25: watch the marker sink far below the freezing line, to -25, a genuinely cold reading. +1. Set T1 to 5 and dT to -12. The final temperature is -7. Follow the arrow from 5 to -7 on the number line. +2. Keep dT at -12 and set T1 to 20. The temperature still falls by 12 degrees, but now it ends at 8. +3. Set T1 to -3 and dT to 10. The temperature rises through zero and reaches 7. ## Real-life examples -1. **An overnight frost.** T1 = 5, dT = -12: a 5-degree morning cools by 12 degrees overnight, ending at -7, below freezing. -2. **A warm front arrives.** T1 = -3, dT = 10: a -3-degree morning warms by 10 degrees, ending at 7, above freezing. -3. **A cold snap.** T1 = 0, dT = -25: a freezing-point day is hit by a cold front 25 degrees strong, ending at -25. +1. **A cold night.** The temperature starts at 5°C and falls by 12 degrees. It ends at -7°C. +2. **A warmer morning.** The temperature starts at -3°C and rises by 10 degrees. It ends at 7°C. +3. **A large temperature drop.** Starting at 0°C, a fall of 25 degrees takes the temperature to -25°C. ## Test yourself -1. Find a starting temperature and change that land exactly on 0, the freezing line. -2. Find a combination that ends below -20 degrees. -3. Find a combination that ends above 30 degrees. +1. Choose a starting temperature and a change that give a final temperature of 0°C. +2. Make the final temperature lower than -20°C. +3. Make the final temperature higher than 30°C. ## Intuition -A thermometer is a number line standing on end: zero marks freezing, numbers above it are warmer, numbers below it are colder — and colder means further below zero, not smaller in some other sense. On screen, drag T1 to set where the reading starts, then drag dT to add a change: a positive dT slides the marker up the number line, a negative one slides it down, straight through zero if the change is large enough. +At 5°C, a drop of 5 degrees takes the temperature to zero. If it falls another 7 degrees, we call the temperature -7°C, or seven degrees below zero. The minus sign tells us which side of zero the temperature is on. -Adding a negative number is exactly this leftward slide. Starting at 5 and adding -12 is not some special rule to memorise — it is the same "move right for positive, move left for negative" arrow you would use for any addition, just crossing zero along the way. Land at -7, and the number line shows plainly that -7 sits further left than 0, which is further left than -3: -7 is the coldest of the three, even though 7 by itself looks like the "biggest" digit. +On the number line, values increase to the right and decrease to the left. To add -12 to 5, move 12 units left: 5 units take you to zero and the remaining 7 take you to -7. Adding a negative number has the same effect as subtracting its distance from zero. + +Compare -7 and -3 on the line. The number -7 is further left, so it is smaller. That is why -7°C is colder than -3°C. The digit 7 is larger than 3, but the minus signs change how we compare these numbers. ## Formal -Adding a signed change $\Delta T$ to a starting value $T_1$ gives $T_2 = T_1 + \Delta T$, where a negative $\Delta T$ moves $T_2$ to the left of $T_1$ on the number line by that many units. +We use $\Delta T$ for the temperature change and $T_1$ for the starting temperature. The final temperature is $T_2 = T_1 + \Delta T$. A positive change raises the temperature; a negative change lowers it. -For any two numbers on the line, the one further to the left is the smaller one: $-7 < -3 < 0 < 7$, regardless of how many digits each number has. +Numbers on a number line increase from left to right. For example, $-7 < -3 < 0 < 7$. The symbol < means “is less than”. ## Advanced -Distance from zero (magnitude) and position relative to zero (sign) are two separate pieces of information carried by a single signed number; comparing two negative numbers by size means comparing their magnitudes and then reversing the order, which is exactly why -7 is less than -3 even though 7 is greater than 3. +A number's absolute value is its distance from zero, without its sign. Both -7 and 7 have absolute value 7. Among negative numbers, the one with the greater absolute value is smaller because it lies further left. ## Derivation -1. Start at 5 and add a change of -12. -2. Adding -12 is the same as subtracting 12. -3. 5 minus 12 leaves -7. +1. Start at 5°C. A fall of 12 degrees is a change of -12. +2. Adding -12 gives the same result as subtracting 12. +3. Subtract 5 to reach zero, then subtract the remaining 7. The result is -7°C. ## Real world -### Weather reports -Overnight lows and wind-chill readings are routinely negative — a forecast of -7°C means 7 degrees below the freezing line, not "minus" in some abstract sense. +### Temperature + +A reading of -7°C means seven degrees below 0°C. It does not mean that there is no heat. + +### Money owed -### Bank balances and debt -A balance of -50 dollars means you owe 50 dollars — the same number line, with 0 as "owing nothing" and negative values as debt rather than savings. +If you record money you have as positive and money you owe as negative, a debt of 50 is recorded as -50. Repaying 20 changes that balance to -30. -### Elevation -Death Valley sits at about -86 metres, below sea level (0); a mountain at 2,000 metres and a valley at -86 metres are compared on the very same signed number line. +### Height relative to a reference -### Sports and games -A golf score of -4 (four under par) beats a score of +2, because lower is better in golf — the same number line, read in the direction that matches the game. +If sea level is our zero, a point 10 metres below it has height -10 metres. A negative height describes a position below the chosen reference. From 7b21096b2831c22c9843b361bb42ccb968356f8e Mon Sep 17 00:00:00 2001 From: ru44 <18311071+ru44@users.noreply.github.com> Date: Mon, 16 Nov 2026 09:30:49 +0300 Subject: [PATCH 3/6] content: clarify fractions and decimals in both languages --- .../numbers/fractions-and-decimals/ar.md | 61 ++++++++++--------- .../numbers/fractions-and-decimals/en.md | 60 +++++++++--------- 2 files changed, 61 insertions(+), 60 deletions(-) diff --git a/content/lessons/numbers/fractions-and-decimals/ar.md b/content/lessons/numbers/fractions-and-decimals/ar.md index 94b70d14..6b2b5597 100644 --- a/content/lessons/numbers/fractions-and-decimals/ar.md +++ b/content/lessons/numbers/fractions-and-decimals/ar.md @@ -1,65 +1,66 @@ --- title: الكسور والأعداد العشرية -summary: >- - الكمية نفسها كشريحة بيتزا، ونقطة على مسطرة، وعدد عشري. حرّك واحدة فتتحرك الثلاث. +summary: تعرّف كيف يعبر الكسر ثلاثة أرباع والعدد 0.75 عن الكمية نفسها. parameters: - n: الرقم العلوي n (كم شريحة تأخذ) - d: الرقم السفلي d (إلى كم شريحة قُطعت البيتزا) + n: البسط n (عدد الأجزاء المأخوذة) + d: المقام d (عدد الأجزاء المتساوية في الواحد الصحيح) variables: - - 'البسط: كم جزءًا متساويًا لديك' - - 'المقام: كم جزءًا متساويًا يكوّن الكل الواحد' + - البسط؛ عدد الأجزاء المتساوية التي نأخذها + - المقام؛ عدد الأجزاء المتساوية التي تكوّن واحدًا صحيحًا --- ## Try it -1. اضبط «n» على 1 و«d» على 2. تظهر البيتزا شريحة واحدة مظللة من اثنتين. يقف مؤشر المسطرة في منتصف المسافة بين 0 و1. -2. ارفع «d» إلى 8، وأبقِ «n» عند 1. تصبح الشرائح أرفع، وتنكمش القطعة المظللة. تهبط القراءة العشرية من 0.5 إلى 0.125. -3. اجعل «n» يساوي 7 و«d» يساوي 4. تضيء بيتزا كاملة على اليسار، وتبدأ بيتزا ثانية بالامتلاء. يتجاوز مؤشر المسطرة العلامة 1. +1. اضبط n على 1 وd على 2. يتلون نصف الدائرة، ويشير خط الأعداد إلى 0.5. +2. أبقِ n عند 1 وارفع d إلى 8. يصغر حجم كل جزء. الجزء الواحد الآن هو ثُمن، وقيمته 0.125. +3. اضبط n على 7 وd على 4. تمثل الدائرة الصغيرة الملونة واحدًا صحيحًا، وتُظهر الدائرة الكبيرة ثلاثة أرباع أخرى. يشير المؤشر إلى 1.75. ## Real-life examples -1. **تقاسم بيتزا بين اثنين (n = 1، d = 2).** قسّم بيتزا إلى شريحتين، وخذ واحدة. هذا نصف البيتزا، أي 0.5 من الكل. -2. **بيتزا مقطعة لأربعة (n = 3، d = 4).** قسّمها إلى 4 شرائح، وخذ 3. هذه ثلاثة أرباع البيتزا، أي 0.75 من الكل. -3. **بيتزا مقطعة لثمانية (n = 7، d = 8).** قسّمها إلى 8 شرائح رفيعة، وخذ 7. هذه تقريبًا البيتزا كلها، أي 0.875 منها. +1. **نصف بيتزا.** قسّم بيتزا إلى شريحتين متساويتين وخذ واحدة. أخذت نصف البيتزا، أي 0.5 منها. +2. **ثلاثة أرباع بيتزا.** قسّمها إلى 4 شرائح متساوية وخذ 3. أخذت ثلاثة أرباعها، أي 0.75 منها. +3. **سبعة أثمان بيتزا.** قسّمها إلى 8 شرائح متساوية وخذ 7. أخذت 0.875 من البيتزا، وبقيت شريحة واحدة. ## Test yourself -1. جد عدد شرائح يوقف مؤشر المسطرة عند 0.5 بالضبط، علامة المنتصف. -2. اجعل البيتزا تُظهر 7 شرائح مظللة من أصل 8 قطعات. -3. خذ شرائح أكثر مما قُطعت إليه البيتزا. اجعل الكسر بيتزا كاملة أو أكثر. +1. اختر قيمتي n وd ليكون الكسر مساويًا لـ0.5. +2. اجعل الرسم يُظهر 7 أجزاء ملونة من أصل 8 أجزاء متساوية. +3. اختر قيمتي n وd لتكون الكمية واحدًا صحيحًا أو أكثر. ## Intuition -قطّع بيتزا إلى d شرائح متساوية، وخذ n منها. هذا معنى الكسر $\frac{n}{d}$ بالضبط. عدّ شرائح أخذتها من عدد قطعات، لا شيء أصعب من ذلك. حرّك «n» على الشاشة، فيتحول هذا العدد من الشرائح إلى برتقالي. حرّك «d»، فتتضاعف خطوط السكين وتصبح كل شريحة أرفع، لكن حجم البيتزا نفسه لا يتغير. +قسّم بيتزا إلى 4 شرائح متساوية وخذ 3 منها. نقول إنك أخذت ثلاثة أرباعها. في الكسر $\frac{n}{d}$، يسمى العدد السفلي d «المقام»، ويخبرنا إلى كم جزء متساوٍ قسّمنا الواحد الصحيح. أما العدد العلوي n فيسمى «البسط»، ويخبرنا كم جزءًا أخذنا. في هذا المثال، n يساوي 3 وd يساوي 4. -للكمية نفسها مكان على المسطرة أيضًا. ضع علامة عند 0 وعلامة عند 1 على بعد ثابت. اقسم المسافة بينهما إلى d أجزاء متساوية. خذ n من تلك الأجزاء، فتصل إلى النقطة نفسها بالضبط. مؤشر المسطرة والقطعة المظللة من البيتزا يتفقان دائمًا، لأنهما القسمة نفسها بطريقتين مختلفتين. اقرأ موضع المؤشر كعدد عادي مثل 0.75، فهذه هي الطريقة الثالثة، العدد العشري. +يمكننا كتابة الكمية نفسها بعدد عشري. نقسم 3 على 4 فنحصل على 0.75، أي 75 جزءًا من مئة. هذه الكمية تساوي ثلاثة أرباع. وعلى خط الأعداد، يقع المؤشر بعد ثلاثة أرباع المسافة من 0 إلى 1. + +يجب أن تكون الأجزاء متساوية. إذا زدنا d وأبقينا n ثابتًا، يصغر كل جزء فتقل الكمية المأخوذة. وإذا زدنا n وأبقينا d ثابتًا، نأخذ أجزاء أكثر بالحجم نفسه. ويمكن أن يتجاوز الكسر الواحد الصحيح؛ فسبعة أرباع تساوي واحدًا صحيحًا وثلاثة أرباع أخرى. ## Formal -الكسر $\frac{n}{d}$ يعني الكل مقسومًا إلى $d$ أجزاء متساوية، يُؤخذ منها $n$. وقيمته تساوي القسمة $n\div d$ مُجراةً كعدد عشري. +يمثل الكسر $\frac{n}{d}$ عددًا من الأجزاء مقداره n، بعد تقسيم كل واحد صحيح إلى d أجزاء متساوية. نحسب قيمته بالقسمة $n\div d$. ولا يجوز أن يكون المقام صفرًا. -كسران مختلفان في n و d قد يمثّلان النقطة نفسها على المسطرة، فـ $\frac{1}{2}$ و $\frac{4}{8}$ يشيران إلى الموضع نفسه بالضبط، لأن ضرب n و d في العامل نفسه لا يحرّك المؤشر. +الكسور المتكافئة هي كسور لها القيمة نفسها. مثلًا، $\frac{1}{2} = \frac{4}{8}$. إذا ضربنا البسط والمقام في العدد نفسه، بشرط ألا يكون صفرًا، تتغير طريقة تقسيم الأجزاء وعدّها، وتبقى الكمية كما هي. ## Advanced -ينتهي العدد العشري لأي كسر بعد عدد محدود من المنازل حين تكون عوامل d الأولية 2 و5 فقط، كما في $\frac{3}{4}=0.75$. وإلا فإنه يتكرر إلى ما لا نهاية بنمط ثابت، كما في $\frac{1}{3}=0.333\ldots$. والسبب أن القسمة المطولة بمقسوم ثابت لا تنتج إلا عددًا محدودًا من البواقي الممكنة، فلا بد أن يتكرر أحدها في النهاية. +نبسّط الكسر أولًا إلى أبسط صورة. ينتهي تمثيله العشري إذا لم يكن لمقامه عوامل أولية غير 2 و5، مثل $\frac{3}{4}=0.75$. وفي غير ذلك تتكرر أرقامه بنمط ثابت، مثل $\frac{1}{3}=0.333\ldots$. قد تعرض الشاشة عددًا مقربًا، بينما يعبّر الكسر عن القيمة الدقيقة. ## Derivation -1. الكسر $\frac{3}{4}$ هو القسمة 3 على 4. -2. إجراء تلك القسمة كعدد عشري يعطي 0.75. -3. 0.75 هو أيضًا 75 من أصل 100 جزء متساوٍ، الكمية نفسها مقطوعة بطريقة مختلفة. +1. لكتابة الكسر $\frac{3}{4}$ في صورة عشرية، نقسم 3 على 4. +2. ناتج القسمة هو 0.75. +3. يعني العدد 0.75 خمسة وسبعين جزءًا من مئة، وهي الكمية نفسها التي تمثلها ثلاثة أرباع. ## Real world -### الوصفات -وصفة تطلب $\frac{3}{4}$ كوب من الدقيق، وميزان يقرأ 0.75 كوب، يطلبان الكمية نفسها بالضبط. +### وصفات الطعام + +علامة 0.75 كوب على إناء القياس تعطي الكمية نفسها التي تعنيها عبارة «ثلاثة أرباع كوب». ### النقود -الربع دولار هو $\frac{1}{4}$ من الدولار، وأيضًا 0.25 دولار، فالعملات كسور من الدولار الكامل مكتوبة كأعداد عشرية. -### قياس الطول -مسطرة مقسّمة إلى أعشار تتيح لك قراءة الطول كسرًا من المتر أو عددًا عشريًا مباشرة، مثل 0.3 م لـ $\frac{3}{10}$ م. +نصف الريال يساوي 0.50 ريال، وربعه يساوي 0.25 ريال. يتيح لنا العدد العشري كتابة أجزاء الريال. + +### الأطوال -### إحصاءات رياضية -معدل ضرب قدره .750 لثلاث ضربات ناجحة من أربع محاولات هو هذا الكسر بعينه، $\frac{3}{4}$، مكتوبًا كعدد عشري. +الطول 0.3 متر يساوي ثلاثة أعشار المتر، ويساوي أيضًا 30 سنتيمترًا. diff --git a/content/lessons/numbers/fractions-and-decimals/en.md b/content/lessons/numbers/fractions-and-decimals/en.md index 9a8091d6..541a4daf 100644 --- a/content/lessons/numbers/fractions-and-decimals/en.md +++ b/content/lessons/numbers/fractions-and-decimals/en.md @@ -1,66 +1,66 @@ --- title: Fractions and decimals -summary: >- - See the same amount three ways — as a fraction of a pizza, a point on a - ruler, and a decimal number — and watch them move together. +summary: Learn why three quarters and 0.75 describe the same amount. parameters: - n: top number n (how many slices you take) - d: bottom number d (how many slices the pizza is cut into) + n: numerator n (number of parts taken) + d: denominator d (equal parts in one whole) variables: - - the numerator — how many equal parts you have - - the denominator — how many equal parts make one whole + - numerator; the number of equal parts taken + - denominator; the number of equal parts in one whole --- ## Try it -1. Set n to 1 and d to 2: the pizza shows one shaded slice out of two, and the ruler marker sits exactly halfway between 0 and 1. -2. Raise d to 8 while keeping n at 1: the slices get thinner, the shaded wedge shrinks, and the decimal readout drops from 0.5 toward 0.125. -3. Push n past d, to n = 7 and d = 4: a full pizza lights up on the left, a second pizza starts filling, and the ruler marker walks past the mark labelled 1. +1. Set n to 1 and d to 2. Half the circle is shaded, and the number-line marker reads 0.5. +2. Keep n at 1 and increase d to 8. Each part is now smaller. One eighth is 0.125. +3. Set n to 7 and d to 4. The small filled circle represents one whole; the large circle shows the remaining three quarters. The marker reads 1.75. ## Real-life examples -1. **Sharing a pizza between two.** n = 1, d = 2: cut a pizza into 2 slices and take 1 — half a pizza, 0.5 of the whole. -2. **A pizza cut for four.** n = 3, d = 4: cut into 4 slices and take 3 — three-quarters of the pizza, 0.75 of the whole. -3. **A pizza cut for eight.** n = 7, d = 8: cut into 8 thin slices and take 7 — nearly the whole pizza, 0.875 of it. +1. **Half a pizza.** Cut a pizza into 2 equal slices and take 1. You have half, or 0.5 of a pizza. +2. **Three quarters of a pizza.** Cut it into 4 equal slices and take 3. You have three quarters, or 0.75 of a pizza. +3. **Seven eighths of a pizza.** Cut it into 8 equal slices and take 7. You have 0.875 of a pizza, with one slice left. ## Test yourself -1. Find a slice count that lands the ruler marker exactly on 0.5, the halfway mark. -2. Set the pizza to show 7 shaded slices out of 8 cuts. -3. Take more slices than the pizza was cut into, so the fraction reaches a whole pizza or more. +1. Choose n and d so the fraction equals 0.5. +2. Show 7 shaded parts out of 8 equal parts. +3. Choose n and d so the amount is at least one whole. ## Intuition -Cut a pizza into d equal slices and take n of them — that is what the fraction $\frac{n}{d}$ means, nothing more mysterious than a count of slices out of a count of cuts. On screen, drag n and watch that many slices turn orange; drag d and watch the knife lines multiply, cutting each slice thinner without changing the size of the pizza. +Cut a pizza into 4 equal slices and take 3. We call that three quarters. In the fraction $\frac{n}{d}$, the bottom number d tells us how many equal parts make a whole. The top number n tells us how many of those parts we take. Here, n is 3 and d is 4. -The same amount also has a spot on a ruler: mark 0 at one end, 1 a fixed distance away, and split that distance into d equal ticks. Taking n of those ticks lands you at exactly the same fraction of the way along — the marker on the ruler and the shaded pizza always agree, because they are the same division done two different ways. Read the marker's position as a plain number, like 0.75, and you have the third way: the decimal. +A decimal is another way to write the amount. Divide 3 by 4 to get 0.75. This means 75 hundredths of a whole, the same amount as three quarters. On the number line, the marker sits three quarters of the way from 0 to 1. + +The parts must be equal. Increasing d while keeping n fixed makes each part smaller, so you take less. Increasing n while keeping d fixed means taking more parts of the same size. A fraction can also be greater than one: seven quarters make one whole and three quarters more. ## Formal -A fraction $\frac{n}{d}$ means the whole divided into $d$ equal parts, of which $n$ are taken; its value equals the division $n\div d$ carried out as a decimal. +A fraction $\frac{n}{d}$ represents n parts when each whole is split into d equal parts. Its value is $n\div d$. The denominator must not be zero. -Two fractions with different n and d can represent the same point on the ruler — $\frac{1}{2}$ and $\frac{4}{8}$ mark the identical spot — because scaling n and d by the same factor does not move the marker. +Equivalent fractions have the same value. For example, $\frac{1}{2} = \frac{4}{8}$. Multiplying the numerator and denominator by the same nonzero number changes the way we count the parts, but not the amount. ## Advanced -Every fraction's decimal either stops after finitely many digits (when d's only prime factors are 2 and 5, as with $\frac{3}{4}=0.75$) or repeats forever in a fixed block (as with $\frac{1}{3}=0.333\ldots$), a fact that follows from how long division with a fixed divisor can only ever produce finitely many distinct remainders before one repeats. +First reduce a fraction to lowest terms. Its decimal terminates if the denominator has no prime factors other than 2 and 5, as in $\frac{3}{4}=0.75$. Otherwise, the decimal repeats, as in $\frac{1}{3}=0.333\ldots$. A screen may round a repeating decimal; the fraction still gives its exact value. ## Derivation -1. The fraction $\frac{3}{4}$ is the division 3 shared among 4. -2. Carrying out that division as a decimal gives 0.75. -3. 0.75 is also 75 out of 100 equal parts — the same amount, cut a different way. +1. To find the decimal value of $\frac{3}{4}$, divide 3 by 4. +2. The division gives 0.75. +3. The decimal 0.75 means 75 hundredths. It is the same amount as three quarters. ## Real world ### Recipes -A recipe calling for $\frac{3}{4}$ cup of flour and a scale reading 0.75 cups are asking for the exact same amount. + +A measuring jug marked 0.75 cups gives the same amount as three quarters of a cup. ### Money -A quarter is $\frac{1}{4}$ of a dollar and also 0.25 dollars — coins are fractions of a whole dollar written as decimals. -### Measuring length -A ruler marked in tenths lets you read a length as either a fraction of a metre or straight off as a decimal, like 0.3 m for $\frac{3}{10}$ m. +Half a unit of currency is 0.50; a quarter is 0.25. The decimal records parts of the whole unit. + +### Length -### Sports statistics -A batting average like .750 for 3 hits in 4 at-bats is exactly this fraction, $\frac{3}{4}$, written as a decimal. +A length of 0.3 metres is three tenths of a metre. It is also 30 centimetres. From f941641b87daddc9242b067f054b0461399cb0b2 Mon Sep 17 00:00:00 2001 From: ru44 <18311071+ru44@users.noreply.github.com> Date: Mon, 16 Nov 2026 09:30:49 +0300 Subject: [PATCH 4/6] content: explain slope with reproducible examples --- content/lessons/functions/slope/ar.md | 66 ++++++++++++++------------- content/lessons/functions/slope/en.md | 66 ++++++++++++++------------- 2 files changed, 69 insertions(+), 63 deletions(-) diff --git a/content/lessons/functions/slope/ar.md b/content/lessons/functions/slope/ar.md index 9fe416be..a0f1e9d6 100644 --- a/content/lessons/functions/slope/ar.md +++ b/content/lessons/functions/slope/ar.md @@ -1,65 +1,69 @@ --- title: الميل -summary: >- - الميل رقم واحد يخبرك كم يتغير شيء مقابل شيء آخر: سرعة سيارة، أو سعر القطعة. +summary: احسب كم يرتفع الخط أو ينخفض مقابل كل خطوة إلى اليمين. parameters: - m: m — الميل - b: b — نقطة التقاطع - x: النقطة الأولى x₁ - h: المسافة الأفقية Δx + m: الميل m + b: الارتفاع عند x = 0 (b) + x: موضع النقطة الأولى x₁ + h: المسافة الأفقية Δx (h) variables: - - المسافة الأفقية — البعد الأفقي بين النقطتين - - الارتفاع — البعد الرأسي بينهما - - الارتفاع مقسومًا على المسافة الأفقية + - التغير الأفقي من النقطة الأولى إلى الثانية + - التغير الرأسي؛ موجب عند الصعود وسالب عند النزول + - الميل؛ التغير الرأسي مقسومًا على التغير الأفقي --- ## Try it -1. حرّك المنزلق «النقطة الأولى x₁» ببطء إلى اليمين. تتحرك النقطتان معًا على الخط. -2. انظر إلى الرقم «الميل Δy/Δx» تحت الرسم. لا يتغير أينما كانت النقطتان. -3. الآن ارفع المنزلق «m — الميل». يصير الخط أشد انحدارًا ويكبر الرقم. الميل معناه ببساطة: ما مدى الانحدار. +1. اضبط m على 1 وb على 0 وx على 0 وh على 2. بين النقطتين، يمتد الخط وحدتين يمينًا ويرتفع وحدتين. ميله يساوي 1. +2. ارفع h إلى 4. أصبح التغير الأفقي 4 والرأسي 4، والنسبة بينهما ما زالت 1. إبعاد النقطتين لم يغير الميل. +3. أبقِ h عند 4 وغيّر m إلى -1. ينخفض الخط الآن 4 وحدات عند الاتجاه يمينًا. الانخفاض يعني أن الميل سالب. ## Real-life examples -1. **سرعة سيارة ثابتة.** سيارة تسير بميل m=1.5 كم لكل دقيقة (b=0). راقب رحلتها من الدقيقة x=-2 على امتداد 4 دقائق (h=4). نسبة الارتفاع إلى المسافة الأفقية تقرأ 1.5 دائمًا، مطابقة لسرعة السيارة بالضبط. -2. **انحدار منحدر لذوي الاحتياجات.** منحدر لطيف يرتفع m=0.05 وحدة مقابل كل وحدة أفقية، أي انحدار 5%. قِسه على كامل طول المنحدر، 6 وحدات (h=6). تبقى النسبة 0.05 مهما كان الجزء الذي تقيسه من المنحدر. -3. **سعر القطعة الواحدة.** شراء قطع بسعر m=2.5 للقطعة زائد رسم خدمة ثابت قدره 1 (b=1). قارن شراء x=1 قطعة بشراء قطع أخرى بعدها بـ3 (h=3). يبقى الميل 2.5، سعر القطعة الإضافية الواحدة، أيًّا كانت عمليتا الشراء اللتان تقارنهما. +1. **سيارة بسرعة ثابتة.** نختار لحظة مرجعية، ونقيس الزمن x بالدقائق والموقع y بالكيلومترات. من x = -2 إلى x = 2، تقطع سيارة سرعتها 1.5 كم في الدقيقة مسافة 6 كم. الزمن السالب هنا يعني ما قبل اللحظة المرجعية. +2. **قياس منحدر.** يرتفع منحدر 0.3 متر خلال مسافة أفقية قدرها 6 أمتار. نقسم 0.3 على 6 فنحصل على ميل قدره 0.05، أي 5%. +3. **شراء دفاتر.** سعر الدفتر 2.50 ريال، ورسوم التوصيل الثابتة ريال واحد. شراء 4 دفاتر بدلًا من دفتر واحد يزيد التكلفة 7.50 ريالات. نقسم الزيادة على الدفاتر الثلاثة الإضافية، فنحصل على 2.50 ريال لكل دفتر. ## Test yourself -1. جد ميلًا (m) ومسافة أفقية (h) يعطي ضربهما ارتفاعًا يساوي 5 بالضبط. -2. جد m وb بحيث يمر الخط بالنقطة التي عندها x=3 وy=7. -3. اجعل الخط ينخفض بأكثر من 10 وحدات على مسافة أفقية معيّنة، بميل سالب حاد ومسافة أفقية طويلة بما يكفي. +1. غيّر m وh حتى يصبح التغير الرأسي بين النقطتين 5. +2. اضبط x على 3، ثم اختر m وb ليكون ارتفاع النقطة الأولى 7. +3. اختر ميلًا سالبًا ومسافة h كافية لينخفض الخط أكثر من 10 وحدات بين النقطتين. ## Intuition -سيارة تسير بسرعة ثابتة تقطع 1.5 كيلومتر كل دقيقة: بعد 4 دقائق تكون قد قطعت 6 كيلومترات، وبعد 8 دقائق، 12. اختر أي نقطتين على الخط الأزرق هنا وانتقل من إحداهما إلى الأخرى تمامًا كما تقرأ رحلة تلك السيارة: أولًا أفقيًا (المسافة الأفقية، أي الزمن الذي مرّ)، ثم رأسيًا (الارتفاع، أي المسافة المقطوعة). الميل هو ذلك الارتفاع لكل وحدة من المسافة الأفقية. +يرتفع منحدر مترًا واحدًا خلال مسافة أفقية قدرها 5 أمتار. نقسم الارتفاع على المسافة الأفقية، فنحصل على 0.2. هذا هو ميل المنحدر. يخبرنا كم يرتفع مقابل كل متر أفقي، وليس مقابل كل متر نمشيه على سطحه المائل. -اسحب النقطتين إلى جزء مختلف تمامًا من الخط، أو غيّر المسافة الأفقية بمنزلق h. يتغيّر حجم المثلث الصغير في كل مرة، لكن نسبة ضلعيه لا تتغيّر أبدًا. اقرأها تحت الرسم فتجدها ثابتة عند الرقم الذي يحدده منزلق m. الارتفاع ينمو دائمًا بالتناسب نفسه مع المسافة الأفقية، وهذا الثبات هو ما يجعل الخط المستقيم مستقيمًا. +في الرسم، يوضح الخطان المتقطعان التغير الأفقي والتغير الرأسي بين النقطتين المحددتين. نقسم التغير الرأسي على الأفقي لنحسب الميل m. إذا كان الخط مستقيمًا، نحصل على الميل نفسه مهما اخترنا نقطتين مختلفتين عليه. + +اقرأ الخط من اليسار إلى اليمين. إذا كان يصعد فميله موجب، وإذا كان يهبط فميله سالب. أما الخط الأفقي فميله صفر. يرفع المنزلق b الخط كله أو يخفضه، دون أن يغير ميله. ## Formal -من أجل $y = mx + b$ ولأي $x_1 \ne x_2$: $\dfrac{y_2 - y_1}{x_2 - x_1} = \dfrac{m(x_2 - x_1)}{x_2 - x_1} = m$. +في المعادلة $y = mx + b$، يمثل m الميل، ويمثل b ارتفاع الخط عند صفر المحور الأفقي. نختار نقطتين تحققان $x_1 \ne x_2$، حتى لا يكون التغير الأفقي صفرًا. -كل مثلثات الارتفاع والمسافة الأفقية على الخط متشابهة، لذا فإن نسبتها ثابتة لا تتغيّر على طول الخط. +نحسب الميل بالعلاقة $\dfrac{y_2 - y_1}{x_2 - x_1} = \dfrac{m(x_2 - x_1)}{x_2 - x_1} = m$. البسط هو التغير الرأسي، والمقام هو التغير الأفقي. أما الخط الرأسي فتغيره الأفقي صفر، ولذلك لا يمكن حساب ميله بهذه القسمة. ## Advanced -ثبات حاصل قسمة الفرق يميّز التطبيقات الأفينية. تكون $f$ أفينية إذا وفقط إذا كان $\frac{f(x_2)-f(x_1)}{x_2-x_1}$ مستقلًا عن اختيار النقطتين. المشتقة توسّع هذه الفكرة بأن تطلب فقط النهاية عندما تقترب النقطتان من بعضهما حتى تلتقيا. +الدالة التي يكون معدل التغير بين أي نقطتين عليها ثابتًا تسمى دالة تآلفية. يكون رسمها خطًا مستقيمًا قد يمر بنقطة الأصل أو لا يمر بها. على المنحنى، قد يتغير الميل بين نقطتين عند تغيير موضعيهما. تصف المشتقة القيمة التي يقترب منها هذا الميل عندما تقترب النقطة الثانية من الأولى، إذا وُجدت هذه القيمة. ## Derivation -1. احسب قيمة الخط عند مدخلين. -2. اطرح فتُحذف نقطة التقاطع $b$. -3. اقسم على المسافة الأفقية. لا تعتمد النتيجة على أي نقطتين اخترتهما. +1. نستخدم معادلة الخط لكتابة ارتفاع كل نقطة من النقطتين. +2. نطرح الارتفاع الأول من الثاني. يظهر المقدار الثابت $b$ في كليهما، فيُحذف عند الطرح. +3. نقسم على التغير الأفقي، وهو غير صفر. نحصل على m مهما كانت النقطتان المختارتان. ## Real world ### السرعة -في الرسم البياني الذي يبيّن كيف تتغيّر المسافة مع الزمن، الميل هو السرعة، أي الأمتار المقطوعة في كل ثانية تمر. -### الطرق والمنحدرات -الانحدار بنسبة 6% يعني ارتفاع 6 أمتار مقابل كل 100 متر أفقيًا. +في رسم المسافة المقطوعة مع الزمن، يعني الميل 2 متر في الثانية أن المسافة تزيد مترين كل ثانية. + +### الطرق + +ميل الطريق بنسبة 6% يعني ارتفاعه 6 أمتار مقابل كل 100 متر من المسافة الأفقية. + +### المشتريات -### أسعار الوحدة -تتغيّر التكلفة خطيًا مع الكمية، وميل هذا الخط هو سعر القطعة الواحدة. +إذا كان سعر القطعة ثابتًا، فإن ميل رسم التكلفة مقابل عدد القطع يساوي سعر القطعة. رسوم التوصيل الثابتة تزيد التكلفة الابتدائية دون تغيير الميل. diff --git a/content/lessons/functions/slope/en.md b/content/lessons/functions/slope/en.md index d13d3bb1..3becd01a 100644 --- a/content/lessons/functions/slope/en.md +++ b/content/lessons/functions/slope/en.md @@ -1,67 +1,69 @@ --- title: Slope -summary: >- - Learn to read how fast something changes — the single number that tells - you a car's speed, a ramp's steepness, or a price per item, no matter - which two points you compare. +summary: Calculate how much a line rises or falls for each step to the right. parameters: - m: m — slope - b: b — intercept + m: slope m + b: height at x = 0 (b) x: first point x₁ - h: run Δx + h: horizontal gap Δx (h) variables: - - the run — horizontal distance between the two points - - the rise — vertical distance between them - - rise divided by run + - horizontal change from the first point to the second + - vertical change; positive upwards and negative downwards + - slope; vertical change divided by horizontal change --- ## Try it -1. Drag the slider «first point x₁» slowly to the right. The two points move along the line together. -2. Look at the number «slope Δy/Δx» under the picture. It does not change, no matter where the points are. -3. Now move the slider «m — slope» up. The line gets steeper and the number grows. Slope simply means: how steep. +1. Set m to 1, b to 0, x to 0 and h to 2. Between the marked points, the line moves 2 units right and 2 units up. Its slope is 1. +2. Increase h to 4. Both changes are now 4, so their ratio is still 1. Moving the points further apart has not changed the slope. +3. Keep h at 4 and change m to -1. The line now falls 4 units as you move right. A downward change gives a negative slope. ## Real-life examples -1. **A car's steady speed.** Driving at m=1.5 km per minute (b=0), checking the trip from minute x=-2 over a 4-minute stretch (h=4): the rise-over-run ratio always reads 1.5, matching the car's speed exactly. -2. **A wheelchair ramp's grade.** A gentle ramp rises m=0.05 units for every unit it runs — a 5% grade — checked over the full 6-unit length of the ramp (h=6): the ratio still reads 0.05, however much of the ramp you measure. -3. **Price per item.** Buying items costs m=2.5 per item plus a fixed 1-unit service fee (b=1); comparing a purchase of x=1 item to one 3 items later (h=3): the slope still reads 2.5, the price of one more item, no matter which two purchases you compare. +1. **A car moving steadily.** Let x measure minutes relative to a chosen moment, and y measure position in kilometres. From x = -2 to x = 2, a car travelling at 1.5 km per minute moves 6 km. Negative time here means before the chosen moment. +2. **Measuring a ramp.** A ramp rises 0.3 metres over a horizontal distance of 6 metres. Dividing 0.3 by 6 gives a slope of 0.05, also written as 5%. +3. **Buying notebooks.** Each notebook costs 2.50, with a fixed delivery fee of 1. Buying 4 instead of 1 costs an extra 7.50. Divide that increase by the 3 extra notebooks to get 2.50 per notebook. ## Test yourself -1. Find a slope (m) and a run (h) whose rise multiplies out to exactly 5. -2. Find m and b so the line passes through the point where x=3 and y=7. -3. Make the line drop by more than 10 units over some run — a negative slope steep enough, and a run long enough. +1. Adjust m and h so the vertical change between the two points is 5. +2. Set x to 3, then choose m and b so the first point has height 7. +3. Choose a negative m and a large enough h so the line falls by more than 10 units between the points. ## Intuition -A car driving at a steady speed covers 1.5 kilometres every minute: after 4 minutes it has gone 6 kilometres, after 8 minutes, 12. Pick any two moments on the blue line here and walk from one point to the other exactly the way you would read that car's trip: first sideways (the run, how much time passed), then up (the rise, how much distance was covered). Slope is that rise for every unit of run. +Suppose a ramp rises 1 metre over a horizontal distance of 5 metres. Divide the rise by the horizontal distance: 1 divided by 5 is 0.2. This is the ramp's slope. It tells us the rise for each metre travelled horizontally, not along the ramp's surface. -Drag the points to a completely different stretch of the line, or change the run with the h slider. The little triangle changes size every time, yet the ratio of its two sides never changes — read it off under the picture and it stays locked to the number set by the m slider. That constancy, rise always growing in exact step with run, is exactly what makes a straight line straight. +In the graph, the dashed horizontal and vertical segments show these two changes between the marked points. Divide the vertical change by the horizontal change to find the slope m. For a straight line, choosing different points gives the same slope. + +Read the line from left to right. A rising line has positive slope; a falling line has negative slope. A horizontal line has slope zero. The b control moves the line up or down without changing its slope. ## Formal -For $y = mx + b$ and any $x_1 \ne x_2$: $\dfrac{y_2 - y_1}{x_2 - x_1} = \dfrac{m(x_2 - x_1)}{x_2 - x_1} = m$. +In the equation $y = mx + b$, m is the slope and b is the height where x is zero. Choose two points with $x_1 \ne x_2$, so their horizontal change is not zero. -All rise–run triangles on a line are similar, so their ratio is an invariant of the line. +Their slope is $\dfrac{y_2 - y_1}{x_2 - x_1} = \dfrac{m(x_2 - x_1)}{x_2 - x_1} = m$. The numerator is the vertical change; the denominator is the horizontal change. A vertical line has zero horizontal change, so this division cannot give it a slope. ## Advanced -Constant difference quotient characterises affine maps: $f$ is affine iff $\frac{f(x_2)-f(x_1)}{x_2-x_1}$ is independent of the points. The derivative extends this by asking only for the limit as the points merge. +A function with a constant difference quotient is affine, meaning it has the form of a straight line with a possible vertical offset. For a curved graph, the slope between two points can change when you choose different points. The derivative describes the limiting slope as the second point approaches the first, when that limit exists. ## Derivation -1. Evaluate the line at two inputs. -2. Subtract: the intercept $b$ cancels. -3. Divide by the run. The result does not depend on which points you picked. +1. Use the line's equation to write the height at each of the two points. +2. Subtract the first height from the second. The same offset $b$ appears in both, so it cancels. +3. Divide by the nonzero horizontal change. The result is m, regardless of which two points you chose. ## Real world ### Speed -On a distance–time graph, slope is speed: metres gained per second elapsed. -### Roads and ramps -A 6% grade means 6 m of rise per 100 m of run. +On a graph of distance travelled against time, a slope of 2 metres per second means the distance increases by 2 metres each second. + +### Roads + +A road grade of 6% means a rise of 6 metres for every 100 metres of horizontal distance. + +### Shopping -### Unit prices -Cost against quantity is a line whose slope is the price per item. +When each extra item costs the same amount, the slope of total cost against item count is the price per item. A fixed delivery fee changes the starting cost, not the slope. From e271aedef238cc328a8d49198d957bc24d2cf298 Mon Sep 17 00:00:00 2001 From: ru44 <18311071+ru44@users.noreply.github.com> Date: Mon, 16 Nov 2026 09:30:49 +0300 Subject: [PATCH 5/6] content: build derivative intuition before notation --- content/lessons/calculus/derivative/ar.md | 65 ++++++++++++---------- content/lessons/calculus/derivative/en.md | 67 ++++++++++++----------- 2 files changed, 70 insertions(+), 62 deletions(-) diff --git a/content/lessons/calculus/derivative/ar.md b/content/lessons/calculus/derivative/ar.md index 56555bef..b38ed11d 100644 --- a/content/lessons/calculus/derivative/ar.md +++ b/content/lessons/calculus/derivative/ar.md @@ -1,64 +1,69 @@ --- title: المشتقة -summary: >- - عداد السرعة يعرف سرعتك الآن، لا متوسط الرحلة. هذه القراءة اللحظية هي المشتقة. +summary: تعرّف كيف نحسب الميل عند نقطة على منحنى يتغير انحداره من مكان إلى آخر. parameters: - x: النقطة x + x: موضع النقطة x على المنحنى variables: - - المنحنى (الخط المتصل) - - ميله عند كل x (الخط المتقطع) + - قيمة الدالة؛ ارتفاع المنحنى المتصل عند x + - المشتقة؛ ميل المنحنى المتصل عند x، ويمثله الرسم المتقطع --- ## Try it -1. اسحب النقطة إلى أسفل المنحنى تمامًا. يستوي الخط البرتقالي ويقرأ الميل 0. -2. اسحبها إلى اليمين. يميل الخط إلى الأعلى ويكبر رقم الميل. -3. اسحبها إلى يسار القاع. يصير الميل سالبًا، فالمنحنى يهبط هناك. +1. حرّك النقطة إلى x = 0. يصبح الخط المستقيم المار بها أفقيًا، وتكون قراءة الميل 0. +2. حرّكها إلى x = 3. يصعد الخط المستقيم من اليسار إلى اليمين، ويكون ميله 6. +3. حرّكها إلى x = -3. يهبط الخط المستقيم من اليسار إلى اليمين، ويكون ميله -6. ## Real-life examples -1. **الوقوف في قاع وادٍ.** عند أدنى نقطة في المنحنى (x = 0) يكون المماس مستويًا. الميل 0، فلا صعود ولا نزول هناك. -2. **في منتصف صعود شديد.** عند x = 3 يميل المماس بحدة للأعلى. الميل 6، وهذا جزء شديد الانحدار صعودًا. -3. **النزول من الجهة الأخرى.** عند x = 3- يميل المماس للأسفل. الميل 6-، وهذا جزء شديد الانحدار نزولًا. +1. **أدنى نقطة في مسار منحني.** عند x = 0، يكون المماس أفقيًا. الميل عند هذه النقطة صفر، رغم أن المسار يرتفع على جانبيها. +2. **جزء صاعد من المسار.** عند x = 3، يكون ميل المماس 6. إذا تحركنا مسافة أفقية صغيرة يمينًا، يزيد الارتفاع بنحو ستة أمثالها. +3. **جزء هابط من المسار.** عند x = -3، يكون ميل المماس -6. إذا تحركنا مسافة أفقية صغيرة يمينًا، ينقص الارتفاع بنحو ستة أمثالها. ## Test yourself -1. جد النقطة التي يكون عندها الميل 0 بالضبط. -2. جد النقطة التي يكون عندها الميل 6 بالضبط. -3. جد النقطة التي يكون عندها الميل 8- بالضبط. +1. ابحث عن نقطة يكون الميل عندها 0. +2. ابحث عن نقطة يكون الميل عندها 6. +3. ابحث عن نقطة يكون الميل عندها -8. ## Intuition -تخيل أنك تتسلق تلة مسارها هو المنحنى المرسوم على الشاشة. عند أسفل المسار تمامًا (الموضع 0) تكون الأرض مستوية، فلا صعود إطلاقًا. وبعد قليل من المسير (الموضع 3) يصعد المسار بحدة، فترتفع نحو 6 أمتار مقابل كل متر تمشيه للأمام. انحدار المسار مختلف عند كل نقطة، فلا يوجد رقم واحد يصف "ميل" التلة كلها. +للمنحدر المستقيم ميل ثابت على امتداده. أما المسار المنحني فقد يكون شبه مستوٍ في مكان، وشديد الانحدار في مكان آخر. لذلك نحتاج إلى حساب الميل عند كل نقطة. هذا ما تعطينا إياه المشتقة. -اسحب النقطة على طول المنحنى. النقطة الصغيرة على الخط المتقطع أسفلها تسجّل ميل الخط المماس البرتقالي عند تلك النقطة بالضبط، أي انحدار المسار هناك، لا في أي مكان آخر. اجمع هذه القراءة عند كل نقطة فتحصل على منحنى جديد كليًا يُسمى المشتقة. يكون سالبًا حين يهبط المسار، صفرًا بالضبط عند القاع المستوي، وموجبًا حين يصعد. +يمثل المنحنى المتصل الدالة. حرّك النقطة عليه وتابع الخط المستقيم المار بها. يسمى هذا الخط «المماس»، لأنه يتبع اتجاه المنحنى عند تلك النقطة. ميله هو قيمة المشتقة هناك. إذا كانت موجبة، يصعد المنحنى عند الاتجاه يمينًا؛ وإذا كانت سالبة، يهبط. + +يسجل الرسم المتقطع قيم هذا الميل. عند x = 3، يكون ارتفاعه 6 لأن ميل المنحنى المتصل هناك يساوي 6. هذه قراءة للتغير قرب النقطة. لا تعني أن الانتقال وحدة كاملة يزيد الارتفاع 6 بالضبط، لأن الميل يتغير أثناء الانتقال. ## Formal -$f'(x) = \lim_{h \to 0} \dfrac{f(x+h) - f(x)}{h}$، بشرط أن تكون هذه النهاية موجودة. +نختار نقطتين متقاربتين، المسافة الأفقية بينهما h. نقسم الفرق بين ارتفاعيهما على h لنحسب الميل بينهما. المشتقة هي القيمة التي تقترب منها هذه النسبة عندما تقترب h من الصفر، أي $f'(x) = \lim_{h \to 0} \dfrac{f(x+h) - f(x)}{h}$، بشرط وجود هذه النهاية. نقترب من الصفر دون أن نقسم عليه. -المماس عند $x_0$ هو أفضل تقريب خطي للدالة، أي $f(x) \approx f(x_0) + f'(x_0)(x - x_0)$. +قرب موضع نختاره ونسميه $x_0$، يعطينا المماس التقريب الخطي $f(x) \approx f(x_0) + f'(x_0)(x - x_0)$. نبدأ بارتفاع النقطة، ثم نضيف حاصل ضرب الميل في التغير الأفقي الصغير. ## Advanced -القابلية للاشتقاق عند $x_0$ تعني أن $f(x_0 + h) = f(x_0) + f'(x_0)h + o(h)$، أي أن خطأ المماس يتقلص أسرع من $h$ نفسها. القابلية للاشتقاق تستلزم الاتصال، لكن العكس ليس صحيحًا، فالدالة $|x|$ عند الصفر لها ميلان من جهتين مختلفتين ولا يوجد لها مماس. +قابلية الاشتقاق عند $x_0$ تعني أن $f(x_0 + h) = f(x_0) + f'(x_0)h + o(h)$. يشير الرمز o(h) إلى خطأ تقريب تقترب نسبته إلى h من الصفر. كل دالة قابلة للاشتقاق متصلة، لكن الدالة المتصلة قد لا تكون قابلة للاشتقاق. مثلًا، للدالة $|x|$ ميل -1 يسار الصفر وميل 1 يمينه، ولذلك لا توجد مشتقتها عند الصفر. ## Derivation -1. ميل القاطع المار بالنقطتين $x$ و $x + h$. -2. افتح الحدود واحذف $h$ (وهذا مسموح لأن $h \ne 0$). -3. دع النقطة الثانية تنزلق نحو الأولى. عندها يتحوّل القاطع إلى مماس. +1. نأخذ نقطتين عند $x$ و$x + h$. في دالة التربيع، نطرح ارتفاعيهما ثم نقسم على المسافة الأفقية h بينهما. +2. نفك مربع المجموع ونحذف الحدود المشتركة. ثم نقسم على $h$، وهذا مسموح لأن $h \ne 0$. نحصل على 2x + h. +3. نجعل h تقترب من الصفر. يقترب الميل بين النقطتين من 2x، فتكون هذه مشتقة دالة التربيع. ## Real world -### السرعة والتسارع -السرعة هي مشتقة الموضع، والتسارع هو مشتقة السرعة. +### الحركة + +إذا كانت الدالة تصف الموقع مع الزمن، فإن مشتقتها تصف السرعة المتجهة في لحظة معينة. ومشتقة السرعة المتجهة هي التسارع. + +### البحث عن القيم العظمى والصغرى + +عند نقطة عظمى أو صغرى داخل المجال، تكون المشتقة صفرًا إذا كانت موجودة. لكن المشتقة الصفرية وحدها لا تكفي؛ فقد يستوي المنحنى لحظة ثم يواصل الصعود. + +### تكلفة الإنتاج -### الأمثلية -تقع القيم العظمى والصغرى حيث تساوي المشتقة صفرًا، أي حيث يكون المماس أفقيًا. +تقدّر مشتقة التكلفة الكلية مقدار زيادة التكلفة عند زيادة الإنتاج قليلًا. ويمكن استخدامها لتقريب تكلفة وحدة إضافية إذا لم يتغير المعدل كثيرًا خلال تلك الوحدة. -### الاقتصاد -التكلفة الحدية هي مشتقة التكلفة الكلية، أي تكلفة إنتاج وحدة إضافية واحدة. +### تدريب نموذج -### تعلم الآلة -خوارزمية الانحدار التدريجي تدرّب النماذج بالتحرك خطوة بخطوة عكس اتجاه مشتقة الخطأ. +توضح المشتقات كيف يؤثر تغيير صغير في أحد معاملات النموذج على خطئه. تستخدم خوارزمية التدريب هذه المعلومات لاختيار تعديل يُتوقع أن يقلل الخطأ. diff --git a/content/lessons/calculus/derivative/en.md b/content/lessons/calculus/derivative/en.md index 0698b2b2..f98b98be 100644 --- a/content/lessons/calculus/derivative/en.md +++ b/content/lessons/calculus/derivative/en.md @@ -1,66 +1,69 @@ --- title: Derivative -summary: >- - A car's speedometer needs to know how fast you're going right now, not your - average for the whole trip — that instant reading is what a derivative - gives you. +summary: Find the slope at one point on a curve, even when the slope changes along it. parameters: - x: point x + x: position x on the curve variables: - - the curve (solid) - - its slope at each x (dashed) + - the function value; the height of the solid curve at x + - the derivative; the slope of the solid curve at x, shown by the dashed graph --- ## Try it -1. Drag the point to the very bottom of the curve. The orange line lies flat and the slope reads 0. -2. Drag it to the right. The line tilts up and the slope number grows. -3. Drag it to the left of the bottom. The slope turns negative: the curve is going downhill there. +1. Move the point to x = 0. The straight line through it is horizontal, and the slope is 0. +2. Move to x = 3. The straight line rises from left to right, and its slope is 6. +3. Move to x = -3. The straight line falls from left to right, and its slope is -6. ## Real-life examples -1. **Standing at the bottom of a valley.** At the curve's lowest point (x = 0) the tangent is flat: slope 0, no climbing needed in either direction. -2. **Partway up a steep climb.** At x = 3 the tangent tilts sharply upward: slope 6, a steep uphill stretch. -3. **Descending the other side.** At x = -3 the tangent tilts down: slope -6, a steep downhill. +1. **The bottom of a curved path.** At x = 0, the tangent is horizontal. The slope at this point is zero, even though the path rises on both sides. +2. **An uphill section.** At x = 3, the tangent has slope 6. For a small horizontal step to the right, the rise is approximately six times that step. +3. **A downhill section.** At x = -3, the tangent has slope -6. For a small horizontal step to the right, the height decreases by approximately six times that step. ## Test yourself -1. Find the point where the slope is exactly 0. -2. Find the point where the slope is exactly 6. -3. Find the point where the slope is exactly -8. +1. Find a point where the slope is 0. +2. Find a point where the slope is 6. +3. Find a point where the slope is -8. ## Intuition -Imagine hiking up a hill whose path is drawn as the curve on screen. At the very bottom of the path (position 0) the ground is flat — no climbing at all. A bit further along (position 3) the path climbs steeply, gaining about 6 metres of height for every metre you walk forward. The path's steepness is different at every point, so there is no single number for "the slope" of the whole hill. +A straight ramp has the same slope all the way along. A curved path can be nearly flat in one place and steep in another. To describe it, we need a slope at each point. This is what the derivative gives us. -Drag the point along the curve. The small dot on the dashed line beneath it copies down the orange tangent line's slope at exactly that spot — the steepness right there, nowhere else. Collect that reading at every point and you get a brand-new curve, called the derivative: negative while the path is heading downhill, zero exactly at the flat bottom, positive while it is climbing. +The solid curve shows the function. Move the point and watch the straight line through it turn. This line is the tangent: it follows the curve's direction at that point. Its slope is the derivative there. A positive value means the curve rises as you move right; a negative value means it falls. + +The dashed graph records these slopes. At x = 3, its height is 6 because the solid curve's slope there is 6. This describes a local rate of change. It does not mean that moving a whole unit along the curve increases its height by exactly 6, because the slope changes as you move. ## Formal -$f'(x) = \lim_{h \to 0} \dfrac{f(x+h) - f(x)}{h}$, provided the limit exists. +Choose two nearby points, separated horizontally by h. Their vertical change divided by h gives the slope between them. The derivative is the value this ratio approaches as h approaches zero: $f'(x) = \lim_{h \to 0} \dfrac{f(x+h) - f(x)}{h}$, provided the limit exists. We approach zero without dividing by zero. -The tangent at $x_0$ is the best linear approximation: $f(x) \approx f(x_0) + f'(x_0)(x - x_0)$. +Near a chosen position $x_0$, the tangent gives a linear approximation: $f(x) \approx f(x_0) + f'(x_0)(x - x_0)$. Start with the height at the chosen point, then add the slope times the small horizontal change. ## Advanced -Differentiability at $x_0$ means $f(x_0 + h) = f(x_0) + f'(x_0)h + o(h)$: the error of the tangent shrinks faster than $h$ itself. Differentiable implies continuous, but not conversely — $|x|$ at 0 has two one-sided slopes and no tangent. +Differentiability at $x_0$ means $f(x_0 + h) = f(x_0) + f'(x_0)h + o(h)$. The notation o(h) means that the approximation error divided by h tends to zero. A differentiable function is continuous, but a continuous function need not be differentiable. For example, $|x|$ has slopes -1 and 1 on opposite sides of zero, so it has no derivative there. ## Derivation -1. Slope of the secant through $x$ and $x + h$. -2. Expand and cancel $h$ (allowed, because $h \ne 0$). -3. Let the second point slide into the first. The secant becomes the tangent. +1. Take two points at $x$ and $x + h$. For the square function, subtract their heights and divide by their horizontal separation h. +2. Expand the square and cancel the common terms. Then divide by $h$, which is allowed because $h \ne 0$. The result is 2x + h. +3. Let h approach zero. The slope between the points approaches 2x, so this is the derivative of the square function. ## Real world -### Velocity and acceleration -Velocity is the derivative of position; acceleration is the derivative of velocity. +### Motion + +If a function gives position over time, its derivative gives velocity at a particular moment. The derivative of velocity gives acceleration. + +### Finding high and low points + +At an interior maximum or minimum where a function is differentiable, its derivative is zero. A zero derivative alone does not guarantee a maximum or minimum; the graph may flatten briefly and keep rising. + +### Production costs -### Optimization -Maxima and minima sit where the derivative is zero — the tangent is flat. +The derivative of total cost with respect to quantity estimates the cost of producing a little more. It approximates the cost of one extra unit when the rate changes little over that unit. -### Economics -Marginal cost is the derivative of total cost: the price of making one more unit. +### Training a model -### Machine learning -Gradient descent trains models by repeatedly stepping against the derivative of the error. +Derivatives tell a learning algorithm how a small change in a parameter affects its error. The algorithm uses that information to choose an adjustment that aims to reduce the error. From 61c63afa1164ee7371179329f69bbb506cfc2624 Mon Sep 17 00:00:00 2001 From: ru44 <18311071+ru44@users.noreply.github.com> Date: Mon, 16 Nov 2026 09:30:49 +0300 Subject: [PATCH 6/6] docs: define a bilingual teaching and editorial review standard --- CONTRIBUTING.md | 2 +- content/lessons/STYLE.ar.md | 119 ++++++++++++++++------------------ content/lessons/STYLE.en.md | 42 ++++++++++++ scripts/content/new-lesson.ts | 10 +-- 4 files changed, 105 insertions(+), 68 deletions(-) create mode 100644 content/lessons/STYLE.en.md diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 40682fd3..ad579887 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -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 diff --git a/content/lessons/STYLE.ar.md b/content/lessons/STYLE.ar.md index 86f1920c..48e33cd9 100644 --- a/content/lessons/STYLE.ar.md +++ b/content/lessons/STYLE.ar.md @@ -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 بين اللغتين، ومن تطابق الصيغ `$…$` في الملخص وهذين القسمين وخطوات الاشتقاق. عدّل النسختين معًا عند إعادة تنظيمهما. نجاح الفحص يثبت سلامة البنية، ولا يثبت جودة الشرح. diff --git a/content/lessons/STYLE.en.md b/content/lessons/STYLE.en.md new file mode 100644 index 00000000..1ad81d49 --- /dev/null +++ b/content/lessons/STYLE.en.md @@ -0,0 +1,42 @@ +# Writing lessons for a first encounter + +Write as a teacher helping a student understand an unfamiliar idea. A fluent sentence is not enough: the reader should be able to explain the idea and predict what happens when they change an input. + +## Build an explanation + +1. Begin with a small question or worked example. Use an everyday situation when it fits; do not force an analogy into every topic. +2. Explain the idea before introducing its technical name. Keep the correct term and give it a meaning the student can use. +3. Connect the example to the actual diagram. Explain what the axes, marks and values represent. +4. Change one quantity while holding the others fixed. Explain both the observation and its cause. +5. Introduce notation after its meaning. Define symbols and units before relying on them. +6. Use Formal to state the rule and its conditions. Explain the relationship in words as well as symbols. +7. Explain where an approximation or analogy stops working. A tangent's slope describes nearby changes; it does not predict an exact change over an arbitrary interval. + +Use short, connected sentences without making the prose choppy. Do not enforce a word count, require an analogy, or add stock phrases to every lesson. Avoid “obviously”, “nothing more mysterious”, “simply” as reassurance, and claims that something is easy. Remove theatrical descriptions when a concrete explanation would teach more. + +## Check every learner-facing part + +- **Title and summary:** say what the student will learn, without unexplained jargon or hype. +- **Try it:** give reproducible settings, an observation, and its meaning. Check the component before naming colors, gestures or animations. +- **Intuition:** build understanding rather than repeating slider instructions. Show the reasoning in a numerical example. +- **Formal:** explain each symbol and relevant condition, including zero denominators and domains. +- **Advanced:** add depth without putting information needed for the first explanation here. +- **Derivation:** explain why each step follows from the last. +- **Examples:** match preset values and units. Explain reference points when negative time or position appears. +- **Challenges:** describe the condition the checker actually evaluates. Include all controls a student must set. + +## Review Arabic and English together + +Read the lesson configuration and visualization implementation before rewriting. Recalculate numerical examples. Check that approximations, signs, units, and claims about maxima or minima are accurate. Fix a shared error in both languages. + +Arabic is independently written teaching prose, not a sentence-by-sentence translation. Follow [the Arabic guide](STYLE.ar.md). Each language may use its own wording and familiar examples while teaching the same idea. + +Keep the Markdown section headings because the parser uses them. The validator currently requires matching Intuition and Formal paragraph counts, matching Try it step counts, and identical math segments in the summary, Intuition, Formal and derivation notes. Coordinate structural edits across translations. + +Run `pnpm check` after editing. It validates structure, formulas and challenge solvability; it cannot establish that the prose is natural or that the explanation teaches well. Read both versions aloud and ask whether a first-time learner could explain why the result changes. + +## Reviewed examples and remaining work + +The following lessons have received a complete bilingual editorial pass under this guide: `place-value`, `negative-numbers`, `fractions-and-decimals`, `slope`, and `derivative`. They demonstrate the intended approach, not a claim that the catalog has been reviewed. + +The remaining lessons still need individual review of their summaries, controls, explanations, examples and challenges. Track progress by lesson, and do not treat a global phrase replacement or a successful build as an editorial review. diff --git a/scripts/content/new-lesson.ts b/scripts/content/new-lesson.ts index 2621f66e..8df1607d 100644 --- a/scripts/content/new-lesson.ts +++ b/scripts/content/new-lesson.ts @@ -51,13 +51,13 @@ charts: [] ## Intuition -First paragraph. Refer to what the learner sees and drags. Inline maths goes between dollars: $f(x) = x^2$. +Start with one concrete question or worked example. Explain the idea before its name or symbols. Follow content/lessons/STYLE.en.md; for Arabic, also read STYLE.ar.md. -Second paragraph. +Connect the example to the actual diagram. Explain what changes, what stays fixed, and why. Define symbols before using them; inline maths goes between dollars: $f(x) = x^2$. ## Formal -The precise statement, with $\\LaTeX$ between dollars. +State the rule and its conditions. Define each symbol and explain the equation in words. Put mathematical notation between dollars. ## Advanced @@ -65,12 +65,12 @@ One paragraph for university level and above (optional). ## Derivation -1. Note for step 1, matching derivation[0] in lesson.yaml. +1. Explain why step 1 follows, matching derivation[0] in lesson.yaml. ## Real world ### Where it is used -One or two sentences. +Give a specific use and explain how this concept helps. Check values and units. `, ) console.log('created ' + dir + '\nnext: fill lesson.yaml and en.md, then `npm run check`')