Tweak language and fix small errors

Author: microbit-robert

docs/ml_is_event_detected.md

@@ -6,7 +6,7 @@ Checks if an ML action is the estimated action.
 ml.isDetected(ml.event.Unknown)
 ```
 
-The ML model updates its estimated action several times a second. This function compares the latest value of the estimated value to the action you choose. Use the boolean value to make logical decisions in your program.
+The ML model updates its estimated action several times a second. This function returns `true` if the chosen action is currently estimated. Use the boolean value to make logical decisions in your program.
 
 Some programs will be easier to write using the “on ML start” and “on ML stop” event handlers instead.
 

docs/ml_on_event_stop.md

@@ -1,6 +1,6 @@
 # on ML stop
 
-Start an [event handler](/reference/event-handler) (part of the program that will run when something happens). This handler works when the ML model’s estimated action changes to the action you select.
+Start an [event handler](/reference/event-handler) (part of the program that will run when something happens). This handler works when the ML model’s estimated action changes from the action you select.
 
 ```sig
 ml.onStop(ml.event.Unknown, function () {

docs/ml_on_event_stop_detailed.md

@@ -1,6 +1,6 @@
 # on ML stop
 
-Start an [event handler](/reference/event-handler) (part of the program that will run when something happens). This handler works when the ML model’s estimated action changes to the action you select.
+Start an [event handler](/reference/event-handler) (part of the program that will run when something happens). This handler works when the ML model’s estimated action changes from the action you select.
 
 ```sig
 ml.onStopDetailed(ml.event.Unknown, function (duration) {