Update tutorial

Signed-off-by: Louis Mandel <[email protected]>

Author: mandel

docs/tutorial.md

@@ -794,7 +794,7 @@ This results in the following output:
 {"Bob": 1, "Carol": 2, "David": 3, "Ernest": 4}
 ```
 
-### While Loop
+### Other loops
 
 The following example shows a while loop in PDL:
 
@@ -804,8 +804,14 @@ The following example shows a while loop in PDL:
 
 The `while` field indicates the looping condition and `repeat` contains the body of the loop.
 
-Notice that `for`, `while`, `until`, and `maxIterations` can all be combined in the same `repeat` block. The loop exits
-as soon as one of the exit conditions is satisfied:
+This loop can be rewritten using `max_iterations` to bound the number of iterations and `index` to name the iteration number.
+
+```yaml
+--8<-- "./examples/tutorial/loop_index.pdl"
+```
+
+
+Notice that `for`, `while`, `until`, and `max_iterations` can all be combined in the same `repeat` block. The loop exits as soon as one of the exit conditions is satisfied:
 
 ```yaml
 --8<-- "./examples/tutorial/repeat.pdl"

examples/tutorial/loop_index.pdl

@@ -0,0 +1,4 @@
+index: i
+repeat:
+  text: ${i + 1}
+max_iterations: 3

examples/tutorial/repeat.pdl

@@ -1,13 +1,14 @@
 description: repeat loop with multiple conditions
 defs:
   numbers:
-    data: [1, 2, 3, 4]
+    data: [42, 2, 4012, 27]
   names:
     data: ["Bob", "Carol", "David", "Ernest"]
 for:
   number: ${ numbers }
   name: ${ names }
+index: i
 repeat:
-  "${ name }'s number is ${ number }\n"
+  "${i}: ${ name }'s number is ${ number }\n"
 until: ${ name == "Carol"}
-max_iterations: 1
+max_iterations: 3

tests/results/examples/tutorial/loop_index.0.result

@@ -0,0 +1 @@
+123

tests/results/examples/tutorial/repeat.0.result

@@ -1 +1,3 @@
-Bob's number is 1
+0: Bob's number is 42
+1: Carol's number is 2
+