Merge pull request #388 from srobo/pre-kickstart-docs-runthrough

Pre Kickstart docs run-through

Author: sedders123

_data/kit_versions.yml

@@ -2,4 +2,5 @@
 # The format of this file should be like such:
 # - version: 20xx.y.z
 #   released: 2038-01-19
-[]
+- version: 2023.0.0
+  released: 2022-10-21

kit/brain_board/index.md

@@ -16,7 +16,7 @@ Brain Board
 <img src="{{ site.baseurl }}/images/content/kit/brain.png" alt="A photo of a brain board" title="A brain board" class="right" style="max-width: 50%"/>
 The Brain Board provided with your kit is what runs the code you write and controls the other peripheral boards. It consists of a [Raspberry Pi 4B](https://www.raspberrypi.com/products/raspberry-pi-4-model-b/) and a Student Robotics KCH HAT.
 
-The LEDs on the HAT display the current status of the robot and can be used to help debug your robot. There are also 3 RGB (Red, Green and Blue) LEDs that you can control from your code.
+The LEDs on the HAT display the current status of the robot and can be used to help debug your robot. There are also 3 RGB (Red, Green, and Blue) LEDs that you can control from your code.
 
 ## Board Diagram
 
@@ -55,7 +55,7 @@ The OK LED shows the status of your code using different colours.
 Your Brain Board will not power on unless it's connected to the "L2" port on the Power Board. 
 This is because the rest of the power outputs are disabled until the usercode runs. 
 
-## Flashing SD card
+## Flashing the SD card
 
 The SD card is located on the underside of the board underneath the green power connector. Grab the SD card with your fingers and simply pull it out of the slot.
 
@@ -66,7 +66,7 @@ The flashing procedure is identical to flashing Raspberry Pi images.
 
 ### Etcher
 
-We recommend using [etcher](https://etcher.io), as it's simple to use, and available on Windows, macOS and Linux. If you're familiar with Raspberry Pis or other similar boards and have flashed images before with a different tool, that will also work.
+We recommend using [Etcher](https://etcher.io), as it's simple to use, and available on Windows, macOS and Linux. If you're familiar with Raspberry Pis or other similar boards and have flashed images before with a different tool, that should also work.
 
 ![Etcher example]({{ site.baseurl }}/images/content/kit/etcher.png)
 

kit/brain_board/updates.md

@@ -8,7 +8,7 @@ extra_js: updates
 
 Keeping your kit up to date is very important. It enables us to deploy new features, as well as fix bugs.
 
-Once you have downloaded the file you need, refer to the documentation on [updating your brain board]({{ site.baseurl }}/kit/brain_board#flashing-sd-card) to apply the update.
+Once you have downloaded the file you need, refer to the documentation on [updating your brain board]({{ site.baseurl }}/kit/brain_board#flashing-the-sd-card) to apply the update.
 
 Each update file is a complete upgrade. Each file contains the changes of those before it. If you need to jump up multiple versions, you can do so by using the latest file.
 

kit/motor_board.md

@@ -9,10 +9,7 @@ Motor Board
 <img src="{{ site.baseurl }}/images/content/kit/mcv4b.png" alt="A phot of an un-cased motor board" title="An un-cased motor board" class="right" />
 The Motor Board can be used to control two 12V DC motors. Your kit contains two of these boards to allow you to control up to four motors. These can be used for moving your robot, although don't feel you are limited to using them for this purpose.
 
-The speed and direction of the two outputs are controlled independently through the USB interface.
-The USB interface is isolated from the rest of the board to prevent damage to the host in the case of a board failure.
-Due to this isolation the board must have power applied to the power connector, from the motor rail on the power board, to function.
-If the board does not have power applied to the power connector then the kit will report that there is a problem with the motor board.
+The speed and direction of the two outputs are controlled independently through the USB connection. The board also needs power delivered from a 12V port on the Power Board in order to drive the motors. 
 
 The motor board uses [pulse-width modulation][wiki-pwm] (PWM) to control the
 amount of power that is sent to the motors.
@@ -25,8 +22,8 @@ Board Diagram
 ![motor board diagram]({{ site.baseurl }}/images/content/kit/mcv4b_board_diagram.png "The Motor Board")
 
 <div class="info">
-The serial and expansion connectors labelled in the above diagram are not currently used by any part of our kit and we don't typically provide support for their use.
-We strongly advise that you do not connect anything to these ports unless you understand their purpose, since incorrect use can damage the kit.
+The expansion connector labelled in the above diagram is not currently used by any part of our kit.
+Do not connect anything to this port, since incorrect use can damage the kit.
 </div>
 
 Indicators
@@ -55,10 +52,10 @@ Specification
 | Output voltage                        | 11.1V ± 15% |
 | Continuous output current per channel | 10A         |
 | Peak output current [^1]              | 20A         |
-| UART connection voltage [^2]          | 3.3–5V      |
+| Serial connection voltage [^2]        | 3.3–5V      |
 
 [^1]: Can be sustained for 1 second, on a single channel.
-[^2]: If the board is controlled solely via the UART connection, this voltage must be supplied via the UART connector.
+[^2]: If the board is controlled solely via the serial connection, this voltage must be supplied via the serial connector. We use the UART serial protocol.
 
 Designs
 -------

kit/power_board.md

@@ -25,8 +25,9 @@ Connectors
 
 There are six power output connectors on the board, labelled L0–L3, H0, and H1.
 These are enabled when your robot code is started, and supply around 11.1V
-(±15%). They should be used to connect to the motor and servo board power
-inputs. The "H" connectors will supply more current than the "L" connectors.
+(±15%). These may be referred to as 12V ports elsewhere in the docs. They should 
+be used to connect to the motor and servo board power inputs. The "H" connectors 
+will supply more current than the "L" connectors.
 
 <div class="warning">
   When connecting the brain board, the "L2" port should be used.
@@ -60,7 +61,7 @@ Indicators
 
 [^1]: The outputs only turn on when your program runs (specifically, when the `Robot` object is created).
 
-On power-up, the Power Board will emit some beeps, which are related to the version of the firmware it has installed.
+On power-up, the Power Board will emit a beep.
 
 If the Power Board starts beeping (and all the outputs turn off) then this
 means that the whole board's current limit has been triggered.

kit/servo_board.md

@@ -23,7 +23,7 @@ Indicators
 | --------------------- | ------------------------------------------------------------------------------------------------ | ---------------------- |
 | Power <!-- DS1 -->    | The board is powered over USB.                                                                   | On                     |
 | 5.5V On <!-- DS15 --> | There is 5.5V power on the board. This usually indicates that the 12V connector rail is powered. | Off                    |
-| Aux On <!-- DS16 -->  | There is auxiliary power on the board.                                                           | Off                    |
+| Aux On <!-- DS16 -->  | There is auxiliary power on the board.                                                           | On                     |
 | STATUS\|ERROR <!-- DS10 --> | Blue when the board has successfully booted<br />Solid pink if an error has occurred (often 12V power being lost) | Blue |
 
 Connectors
@@ -58,7 +58,7 @@ universally the case and some servos do care about the time between pulses as
 well.
 
 The Servo Board is able to precisely control the duration of the pulses sent to
-servos (based on the values you configure using the python API), within the
+servos (based on the values you configure using the Python API), within the
 ranges in the table below.
 
 Conversely the time between pulses sent to a given servo is allowed a much wider