Correct variable use

Author: johnsamuelwrites

_scripts/compile_blocks.py

@@ -122,7 +122,9 @@ def main():
 
     md_files = sorted(
         p for p in Path('.').rglob('*.md')
-        if '.jekyll-cache' not in p.parts and 'vendor' not in p.parts
+        if '.jekyll-cache'   not in p.parts
+        and 'vendor'         not in p.parts
+        and 'multilingual-src' not in p.parts  # CI checkout lives inside docs root
     )
 
     total = compiled = skipped = cached = 0

_tests/test_code_blocks.py

@@ -89,7 +89,9 @@ def _collect_blocks():
 
     md_files = sorted(
         p for p in REPO_ROOT.rglob('*.md')
-        if '.jekyll-cache' not in p.parts and 'vendor' not in p.parts
+        if '.jekyll-cache'   not in p.parts
+        and 'vendor'         not in p.parts
+        and 'multilingual-src' not in p.parts  # CI checkout lives inside docs root
     )
 
     for md_file in md_files:

getting-started/index.md

@@ -87,8 +87,8 @@ Create a file `hello_en.ml`:
 let message = "Hello, multilingual world!"
 let count = 3
 
-for i in range(count):
-    print(f"[{i}] {message}")
+for idx in range(count):
+    print(f"[{idx}] {message}")
 ```
 
 Run it:

getting-started/quick-start.md

@@ -136,24 +136,24 @@ if (n := len(data)) > 3:
 ### for loop
 
 ```python
-for i in range(5):
-    print(i)   # 0, 1, 2, 3, 4
+for idx in range(5):
+    print(idx)   # 0, 1, 2, 3, 4
 
 # Iterate over a list
 let fruits = ["apple", "banana", "cherry"]
 for fruit in fruits:
     print(fruit)
 
 # With enumerate
-for i, fruit in enumerate(fruits):
-    print(f"{i}: {fruit}")
+for idx, fruit in enumerate(fruits):
+    print(f"{idx}: {fruit}")
 ```
 
 ### for / else
 
 ```python
-for i in range(5):
-    if i == 3:
+for idx in range(5):
+    if idx == 3:
         break
 else:
     print("Loop completed without break")
@@ -171,12 +171,12 @@ while count < 5:
 ### break and continue
 
 ```python
-for i in range(10):
-    if i % 2 == 0:
+for idx in range(10):
+    if idx % 2 == 0:
         continue   # skip even
-    if i > 7:
+    if idx > 7:
         break
-    print(i)   # 1, 3, 5, 7
+    print(idx)   # 1, 3, 5, 7
 ```
 
 ---

getting-started/repl.md

@@ -223,8 +223,8 @@ let y = 3
 print(x + y)
 
 let total = 0
-for i in range(4):
-    total = total + i
+for idx in range(4):
+    total = total + idx
 print(total)
 ```
 

language-guide/control-flow.md

@@ -149,8 +149,8 @@ sonst:
 ### English
 
 ```python
-for i in range(5):
-    print(i)
+for idx in range(5):
+    print(idx)
 
 # With else
 for item in [1, 2, 3]:
@@ -219,12 +219,12 @@ for index, letter in pairs:
     print(f"{index}: {letter}")
 
 # enumerate
-for i, val in enumerate(["x", "y", "z"]):
-    print(i, val)
+for idx, val in enumerate(["x", "y", "z"]):
+    print(idx, val)
 
 # zip
-for a, b in zip([1, 2, 3], ["one", "two", "three"]):
-    print(a, b)
+for aa, bb in zip([1, 2, 3], ["one", "two", "three"]):
+    print(aa, bb)
 ```
 
 ---
@@ -432,20 +432,20 @@ These keywords are universal (not localized) across all languages.
 ### break — Exit a loop early
 
 ```python
-for i in range(100):
-    if i == 10:
+for idx in range(100):
+    if idx == 10:
         break
-    print(i)
+    print(idx)
 # prints 0 through 9
 ```
 
 ### continue — Skip current iteration
 
 ```python
-for i in range(10):
-    if i % 2 == 0:
+for idx in range(10):
+    if idx % 2 == 0:
         continue
-    print(i)
+    print(idx)
 # prints 1, 3, 5, 7, 9
 ```
 
@@ -465,9 +465,9 @@ def not_implemented_yet():
 
 ```python
 # Multiplication table
-for i in range(1, 4):
-    for j in range(1, 4):
-        print(f"{i}×{j}={i*j}", end="  ")
+for ii in range(1, 4):
+    for jj in range(1, 4):
+        print(f"{ii}×{jj}={ii*jj}", end="  ")
     print()
 ```
 
@@ -489,8 +489,8 @@ pour i dans intervalle(1, 4):
 let target = 7
 let numbers = [1, 3, 5, 7, 9]
 
-for n in numbers:
-    if n == target:
+for num in numbers:
+    if num == target:
         print(f"Found {target}")
         break
 else:

language-guide/syntax.md

@@ -277,8 +277,8 @@ let add = lambda x, y: x + y
 
 Tuple target:
 ```python
-for i, v in enumerate([10, 20, 30]):
-    print(i, v)
+for idx, val in enumerate([10, 20, 30]):
+    print(idx, val)
 ```
 
 ### while loop