Some edits for the new sensor/motor examples (#901)

* Some edits for the new sensor/motor examples

* article typo

* dark and bright

* fix block styling

* I like 'on'

* more block styling

docs/reference/motors/synced/tank.md

@@ -84,7 +84,7 @@ motors.stopAll()
 
 ### Tank tester
 
-This program lets you change the tank values using the brick buttons
+This program lets you change the tank values using the brick buttons.
 
 ```typescript
 let tankB = 0;

docs/tutorials/coast-or-brake.md

@@ -1,4 +1,6 @@
-# Coast Or Brake
+# Coast or Brake
+
+This code example will set the brake when button **A** is pressed or let the motor coast (turn freely when not running) when button **B** is pressed. The motor is turned by one rotation to cause motion.
 
 ```blocks
 brick.buttonLeft.onEvent(ButtonEvent.Pressed, function () {

docs/tutorials/motors.md

@@ -23,7 +23,7 @@
   "imageUrl":"/static/tutorials/pivot-turn.png"
 }, {
   "name": "Smooth Turn",
-  "description": "Turn the driving base in a smooth motion.",
+  "description": "Turn the driving base in a smooth, steering motion.",
   "cardType": "example",
   "url":"/tutorials/smooth-turn",
   "imageUrl":"/static/tutorials/smooth-turn.png"

docs/tutorials/pause-until-pressed.md

@@ -1,6 +1,6 @@
 # Pause Until Pressed
 
-This is an example of code using a touch sensor to detect a wall or other obstacle. The motors are running until the sensor is pressed.
+This is a code example to detect contact or collision with another object. It uses a touch sensor to detect hitting a wall or other obstacle. The motors are run and then stopped when the sensor is pressed.
 
 ```blocks
 motors.largeBC.tank(50, 50)

docs/tutorials/pivot-turn.md

@@ -1,8 +1,8 @@
 # Pivot Turn
 
-A **pivot turn** happens when a [EV3 Driving Base](https://le-www-live-s.legocdn.com/sc/media/lessons/mindstorms-ev3/building-instructions/ev3-rem-driving-base-79bebfc16bd491186ea9c9069842155e.pdf) turns around a wheel by spinning a single wheel.
+A **pivot turn** happens when a [EV3 Driving Base](https://le-www-live-s.legocdn.com/sc/media/lessons/mindstorms-ev3/building-instructions/ev3-rem-driving-base-79bebfc16bd491186ea9c9069842155e.pdf) turns around the wheel on the inside of the turn by spinning just the single wheel at the outside of the turn.
 
-You can achieve turn with a ``tank`` or a ``steer`` block.
+You can make a turn happen with either a ``||motors:tank||`` or a ``||motors:steer||`` block.
 
 ```blocks
 forever(function() {

docs/tutorials/reflected-light-calibration.md

@@ -1,6 +1,6 @@
 # Reflected light calibration
 
-The ``calibrateLight`` blocks allows you to calibrate the reflected light of the color sensor in one block. Start the block and move the sensor over the dark and bright surface; then stop moving it.
+The ``||sensors:calibrateLight||`` blocks allows you to calibrate the reflected light of the color sensor in one block. At the time you run the block, move the sensor over a dark surface and a bright surface; then stop moving it.
 
 ```blocks
 sensors.color3.onLightDetected(LightIntensityMode.Reflected, Light.Dark, function () {

docs/tutorials/reflected-light-measure.md

@@ -1,7 +1,7 @@
 # Reflected light measure
 
-This example uses a color sensor to measure the reflected light on the dark and light surface
-and set the light/dark thresholds.
+This example uses a color sensor to measure the reflected light from a dark and light surface
+and sets the light/dark thresholds.
 
 ```blocks
 sensors.color3.onLightDetected(LightIntensityMode.Reflected, Light.Dark, function () {

docs/tutorials/smooth-turn.md

@@ -1,8 +1,8 @@
 # Smooth Turn
 
-A **smooth turn** happens when a [EV3 Driving Base](https://le-www-live-s.legocdn.com/sc/media/lessons/mindstorms-ev3/building-instructions/ev3-rem-driving-base-79bebfc16bd491186ea9c9069842155e.pdf) turns around both wheels at a different speed.
+A **smooth turn** happens when a [EV3 Driving Base](https://le-www-live-s.legocdn.com/sc/media/lessons/mindstorms-ev3/building-instructions/ev3-rem-driving-base-79bebfc16bd491186ea9c9069842155e.pdf) makes a turn by spinning both both wheels but with each running at a different speed.
 
-You can achieve turn with a ``tank`` or a ``steer`` block.
+You can make a turn happen with either a ``||motors:tank||`` or a ``||motors:steer||`` block.
 
 ```blocks
 forever(function() {

docs/tutorials/spin-turn.md

@@ -1,8 +1,8 @@
 # Spin Turn
 
-A **spin turn** happens when a [EV3 Driving Base](https://le-www-live-s.legocdn.com/sc/media/lessons/mindstorms-ev3/building-instructions/ev3-rem-driving-base-79bebfc16bd491186ea9c9069842155e.pdf) turns on the spot, by spinning both wheels in opposite directions.
+A **spin turn** happens when a [EV3 Driving Base](https://le-www-live-s.legocdn.com/sc/media/lessons/mindstorms-ev3/building-instructions/ev3-rem-driving-base-79bebfc16bd491186ea9c9069842155e.pdf) turns, or rotates, on a single spot by spinning both wheels, but with each turning in opposite directions.
 
-You can achieve turn with a ``tank`` or a ``steer`` block.
+You can make a turn happen with either a ``||motors:tank||`` or a ``||motors:steer||`` block.
 
 ```blocks
 forever(function() {

docs/tutorials/tank-zigzag.md

@@ -1,7 +1,7 @@
 # Tank ZigZag
 
-This example shows how to use the [tank](/reference/motors/tank) block to keep the speed of 2 large motors synchronized. In this example, a [EV3 Driving Base](https://le-www-live-s.legocdn.com/sc/media/lessons/mindstorms-ev3/building-instructions/ev3-rem-driving-base-79bebfc16bd491186ea9c9069842155e.pdf)
-) will move on a zig zag pattern.
+This example shows how to use the [tank](/reference/motors/tank) block to keep the speed of 2 large motors synchronized. The [EV3 Driving Base](https://le-www-live-s.legocdn.com/sc/media/lessons/mindstorms-ev3/building-instructions/ev3-rem-driving-base-79bebfc16bd491186ea9c9069842155e.pdf)
+) will move in a zig zag pattern.
 
 ```blocks
 /**