From 7e9cc791ec902a66dfa5d83f40e81757fc279a8f Mon Sep 17 00:00:00 2001 From: Galen Nickel Date: Mon, 2 Sep 2019 04:20:42 -0700 Subject: [PATCH] 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 | 2 +- docs/tutorials/coast-or-brake.md | 4 +++- docs/tutorials/motors.md | 2 +- docs/tutorials/pause-until-pressed.md | 2 +- docs/tutorials/pivot-turn.md | 4 ++-- docs/tutorials/reflected-light-calibration.md | 2 +- docs/tutorials/reflected-light-measure.md | 4 ++-- docs/tutorials/smooth-turn.md | 4 ++-- docs/tutorials/spin-turn.md | 4 ++-- docs/tutorials/tank-zigzag.md | 4 ++-- 10 files changed, 17 insertions(+), 15 deletions(-) diff --git a/docs/reference/motors/synced/tank.md b/docs/reference/motors/synced/tank.md index d59950e1..02f046bd 100644 --- a/docs/reference/motors/synced/tank.md +++ b/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; diff --git a/docs/tutorials/coast-or-brake.md b/docs/tutorials/coast-or-brake.md index 145cd0e6..2f74561f 100644 --- a/docs/tutorials/coast-or-brake.md +++ b/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 () { diff --git a/docs/tutorials/motors.md b/docs/tutorials/motors.md index e8e10d38..77df7c83 100644 --- a/docs/tutorials/motors.md +++ b/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" diff --git a/docs/tutorials/pause-until-pressed.md b/docs/tutorials/pause-until-pressed.md index 54e05aa7..b3e7f4c3 100644 --- a/docs/tutorials/pause-until-pressed.md +++ b/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) diff --git a/docs/tutorials/pivot-turn.md b/docs/tutorials/pivot-turn.md index f54018cf..c80b2bed 100644 --- a/docs/tutorials/pivot-turn.md +++ b/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() { diff --git a/docs/tutorials/reflected-light-calibration.md b/docs/tutorials/reflected-light-calibration.md index 4bca31dd..af0ac2ff 100644 --- a/docs/tutorials/reflected-light-calibration.md +++ b/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 () { diff --git a/docs/tutorials/reflected-light-measure.md b/docs/tutorials/reflected-light-measure.md index 8a4a6148..dbd927ee 100644 --- a/docs/tutorials/reflected-light-measure.md +++ b/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 () { diff --git a/docs/tutorials/smooth-turn.md b/docs/tutorials/smooth-turn.md index 71805ac8..c72952a3 100644 --- a/docs/tutorials/smooth-turn.md +++ b/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() { diff --git a/docs/tutorials/spin-turn.md b/docs/tutorials/spin-turn.md index 78b81de6..06430ba7 100644 --- a/docs/tutorials/spin-turn.md +++ b/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() { diff --git a/docs/tutorials/tank-zigzag.md b/docs/tutorials/tank-zigzag.md index 36c535d4..7630f53d 100644 --- a/docs/tutorials/tank-zigzag.md +++ b/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 /**