feedback

Author: x87

src/content/docs/ch01/01-instructions.mdx

@@ -8,6 +8,8 @@ An `instruction` is a single operation in a CLEO script. It is the smallest unit
 
 In Sanny Builder each instruction is written on a separate line. An instruction ends at the end of the line.
 
+When compiled, scripts run from top to bottom. Each instruction is executed in order, one after another. When the game encounters an instruction, it executes it and then moves to the next line.
+
 Let's have a look at the shortest possible script that has only one instruction:
 
 ```sb

src/content/docs/ch02/02-wait.mdx

@@ -22,3 +22,8 @@ print_formatted "Current time: %d:%d" 250 hours minutes
 ```
 
 This script will print the current time, wait for 5 seconds, and then print the time again. Note how the time changes between the two prints.
+
+:::tip
+
+Use `wait` command sparingly. You only need it when you want to pause the script and let the game do other things.
+:::

src/content/docs/ch02/06-quiz.mdx

@@ -39,5 +39,14 @@ import Quiz from '../../../components/Quiz.astro';
 		],
 		correct: 1,
 		hint: "There is a specific command designed to exit a loop early."
+	},
+	{
+		question: "True or false: You must put wait at the start of every code block.",
+		answers: [
+			"True",
+			"False"
+		],
+		correct: 1,
+		hint: "You only need it while waiting on game or player conditions."
 	}
 ]} />

src/content/docs/ch05/02-for-loop.mdx

@@ -28,6 +28,10 @@ end
 
 The variable `i` will take values `1`, `2`, `3`, `4`, `5`, and the loop body will execute 5 times. After the loop, the player has $500 more.
 
+:::note
+FOR's end value is inclusive. The loop runs with the end value as the last iteration. In the example above, `i` takes the value `5` in the last iteration, and then the loop ends.
+:::
+
 ## Counting Backwards with DOWNTO
 
 To count in the opposite direction, use `downto` instead of `to`. The loop variable decreases by `1` after each iteration:

src/content/docs/ch05/06-quiz.mdx

@@ -38,5 +38,14 @@ import Quiz from '../../../components/Quiz.astro';
 		],
 		correct: 2,
 		hint: "It's the opposite of break — instead of leaving the loop, it starts a new iteration"
+	},
+	{
+		question: "True or false: In a for loop, the end value is not used.",
+		answers: [
+			"True",
+			"False"
+		],
+		correct: 1,
+		hint: "The loop variable takes the end value in the last iteration, and then the loop ends."
 	}
 ]} />

src/content/docs/ch07/06-script-vehicle-roulette.mdx

@@ -165,7 +165,7 @@ loadModel(currentModel)
 currentCar = spawnNearPlayer(currentModel)
 ```
 
-`generate_random_int_in_range` picks an index between `0` (inclusive) and `NUM_VEHICLES` (exclusive). That index pulls a model ID from the array, which flows through `loadModel` and `spawnNearPlayer`.
+`generate_random_int_in_range` picks an index between `0` (inclusive) and `NUM_VEHICLES` (exclusive). If `NUM_VEHICLES` is `8`, the possible index to return are `0` to `7`, which matches the valid indices of the `models` array. That index pulls a model ID from the array, which flows through `loadModel` and `spawnNearPlayer`.
 
 Save the file as `vehicle_roulette.txt`, press `F7`, and try your luck!
 

src/content/docs/ch07/07-quiz.mdx

@@ -38,5 +38,14 @@ import Quiz from '../../../components/Quiz.astro';
 		],
 		correct: 2,
 		hint: "If the game's execution flow can reach a function definition without calling it, things won't work correctly."
+	},
+	{
+		question: "True or false: generate_random_int_in_range includes the max value in the result.",
+		answers: [
+			"True",
+			"False"
+		],
+		correct: 1,
+		hint: "The max value is exclusive — the result is always less than it."
 	}
 ]} />