update documentation based on docx

.vuepress/config.js

@@ -65,21 +65,21 @@ const imageSizes = JSON.parse(
 );
 
 const galleryZipSizes = {};
-const zipsPath = path.resolve(__dirname, "..", ".non-vuepress-public", "galleryzips");
-for (const zip of fs.readdirSync(zipsPath)) {
-  const zipPath = path.join(zipsPath, zip);
+ const zipsPath = path.resolve(__dirname, "..", ".non-vuepress-public", "galleryzips");
+ for (const zip of fs.readdirSync(zipsPath)) {
+   const zipPath = path.join(zipsPath, zip);
 
   let size = fs.statSync(zipPath).size;
-  if (size <= 2147483647) {  // If the file is bigger than a buffer it isn't a lfs pointer
-    const data = fs.readFileSync(zipPath, { encoding: "utf8" });
+   if (size <= 2147483647) {  // If the file is bigger than a buffer it isn't a lfs pointer
+     const data = fs.readFileSync(zipPath, { encoding: "utf8" });
     if (data.startsWith("version https://git-lfs.github.com/spec/v1")) {
-      const lines = data.split("\n");
-      size = parseInt(lines[2].split(" ")[1]);
+       const lines = data.split("\n");
+       size = parseInt(lines[2].split(" ")[1]);
     }
-  }
+   }
 
-  galleryZipSizes[zip.substring(0, zip.length - 4)] = size;
-}
+   galleryZipSizes[zip.substring(0, zip.length - 4)] = size;
+ }
 
 function makeGallerySidebar() {
   const galleries = fm(

docs/README.md

@@ -7,14 +7,14 @@ position: 1
 
 Welcome to the docs for **Robocon 2024**!
 
-We suggest you first grasp the (Outdated) idea of the [rules](/docs/rules.md). 
+We suggest you first grasp the idea of the [rules](/docs/rules.md). 
 :::tip
 
 If you are viewing this page on your BrainBox then please check the website for the latest revision.
 
 :::
 
-![Game logo](/images/roboconHeader.png)
+![Game logo](/images/roboconHeader.jpg)
 Once you've done that, you'll need to turn your robot on.
 
 To begin, get familiar with the kit provided. It includes : <!--StartFragment-->
@@ -28,17 +28,18 @@ To begin, get familiar with the kit provided. It includes : <!--StartFragment-->
 | 2     | Motor                     |
 | 2     | Wheels                    |
 | 1     | Caster Wheel              |
-| 1     | Chassis Kit               |
+| 1     | Chassis              |
 | 2     | Servo Motor               |
 | 1     | Start Button              |
 | 1     | Power Switch              |
 
-:::caution- Handling batteries incorrectly can be dangerous. Make sure you follow these [safety guidelines](/docs/charging.html) at all times.
-
+:::warning 
+ Handling batteries incorrectly can be dangerous. Make sure you follow these [safety guidelines](/docs/charging.html) at all times.
+:::
 :::tip
 You can also access these docs from your robot. Go to <http://robot.go/docs> when you're connected to your robot.
 :::
 
-It might also be a good idea to sign up for the [forum](/forum/). You can do this using the registration code provided in your kit. This is a great place to ask questions on anything related to the competition, the kit, or robot programming.
+It might also be a good idea to sign up for the [forum](/forum/).  This is a great place to ask questions on anything related to the competition, the kit, or robot programming.
 
 <!--END_PI_REMOVE-->

docs/gpio.md

@@ -87,33 +87,3 @@ However, the built-in pull-up resistor alleviates this need. It essentially wire
 
 ![An example weak pull up](/images/capture.png)
 
-## Setting multiple pins
-
-When you set multiple pins, you'll need to set them in order. This is due to how the brainbox internally sets pins
-
-For example...<br/>
-This won't work:
-```python
-# Wrong
-import robot
-
-R = robot.Robot()
-
-R.gpio[1].mode = robot.INPUT
-R.gpio[3].mode = robot.INPUT_PULLUP
-R.gpio[2].mode = robot.OUTPUT
-
-# Pin 3 is set before pin 2, which won't work
-```
-But this will:
-```python
-# Right
-import robot
-
-R = robot.Robot()
-
-R.gpio[1].mode = robot.INPUT
-R.gpio[2].mode = robot.OUTPUT
-R.gpio[3].mode = robot.INPUT_PULLUP
-# As all the GPIO pins are set in order, this is fine
-```

docs/hello-gpio.md

@@ -68,3 +68,6 @@ R.gpio[POT_PIN].mode = robot.INPUT_ANALOG
 while True:
     print(R.gpio[POT_PIN].analog)
 ```
+
+## Using distance sensors with retroreflective tape
+//TODO 

docs/hello-motors.md

@@ -22,60 +22,59 @@ R = robot.Robot()
 Motor power is automatically scaled for the 3-6V motors included in the kit, if you are sourcing your own motors then see https://hr-robocon.org/docs/motors.html for how to allow faster speeds.
 :::
 
-Now that everything is set up, it's time to set the motors. All the motors are stored in a list inside the Robot variable - to access the first motor, you can use `R.motors[1]`, the second motor is found with `R.motors[2]`.<br\>
+Now that everything is set up, it's time to set the motors. All the motors are stored in a list inside the Robot variable - to access the first motor, you can use `R.motors[0]`, the second motor is found with `R.motors[1]`.
 
 Changing the speed of the motor is easy - just set the motor to a number from -100 to 100. Immediately setting the power to 100 can have unwanted side effects, so we'll start by setting them to half power:
 ```python
 import time
 import robot
 R = robot.Robot()
 
-R.motors[1] = 50
-R.motors[2] = 50
+R.motors[0] = 50
+R.motors[0] = 50
 ```
-Running this program will make your robot move forwards. Unfortunately, it will never tell it to stop moving forwards, so hopefully you put it on the floor and it hasn't driven off the table.<br>
+Running this program will make you1 roove forwards. Unfortunately, it will never tell it to stop moving forwards, so hopefully you put it on the floor and it hasn't driven off the table.<br>
 To fix this we can set the power of the motors to 0 after a couple seconds:
 ```python
 import time
 import robot
 R = robot.Robot()
 
-R.motors[1] = 50
-R.motors[2] = 50
+R.motors[0] = 50
+R.motors[0] = 50
 
 time.sleep(2)
 
-R.motors[1] = 0
-R.motors[2] = 0
+R.motors[0] = 0
+R.moto1s[0
 ```
-To turn the robot, you just need to set one motor going forwards and the second motor going backwards. The following program makes the robot do a little dance - try it out!
+To turn the robot, you just need to1setmotor going forwards and the second motor going backwards. The following program makes the robot do a little dance - try it out!
 ```python
 speed = 50
 
-R.motors[1] = speed
-R.motors[2] = speed
+R.motors[0] = speed
+R.motors[0] = speed
 
 time.sleep(2)
 
-R.motors[1] = speed
-R.motors[2] = -speed
+R.motors[0] = speed1R.m[0] = -speed
 
 time.sleep(2)
 
-R.motors[1] = -speed
-R.motors[2] = -speed
+R.motors[0] = -spe1d
+Rrs[0] = -speed
 
 time.sleep(2)
 
-R.motors[1] = -speed
-R.motors[2] = speed
+R.motors[0] = -spe1d
+Rrs[0] = speed
 
 time.sleep(2)
 
-R.motors[1] = 0
-R.motors[2] = 0
+R.motors[0] = 0
+R.m1tor= 0
 ```
-A final note, even if you set both motors to the same power, your robot probably won't drive in a perfectly straight line. This is due to defects in the motors, and unless you get specialised motors, no two motors will have the same offset. How your robot deals with this is up to you!
+A final note, even if you set both 1oto the same power, your robot probably won't drive in a perfectly straight line. This is due to defects in the motors, and unless you get specialised motors, no two motors will have the same offset. How your robot deals with this is up to you!
 
 # Troubleshooting and Further Reading
 [Connecting to the robot](/docs/connecting.html) <br>

docs/init-robot.md

@@ -15,4 +15,4 @@ import robot
 R = robot.Robot()
 ```
 
-When you initialise the robot with `robot.Robot()`, your code will be paused until the hardware start button or Shepherd run button is pressed. When the Robot is waiting for either of these buttons to be pressed, the blue status LED will flash on and off.
+When you initialise the robot with `robot.Robot()`, your code will be paused until the hardware start button or Shepherd run button is pressed. When the Robot is waiting for either of these buttons to be pressed, the blue user LED will flash on and off.

docs/minibot-assembly.md

@@ -5,6 +5,6 @@ position: 6
 ---
 # Minibot Assembly
 
-You can download instructions on how to make your minibot [here](/HowToAssembleYourMiniBot.pdf).
+You can download instructions on how to make your minibot [here](/minibot.pdf).
 
 <Embed :aspect-ratio="1/1.4142"><iframe width="100" height="141" src="https://hr-robocon.org/HowToAssembleYourMiniBot.pdf"></iframe></Embed>

docs/motors.md

@@ -20,16 +20,16 @@ If you want to spin your motors in reverse, just stick a negative sign in front
 You can control motors using the `motors` property of the `Robot` object. To set the power of the first motor to 60% use:
 
 ```python
-R.motors[1] = 60
+R.motors[0] = 60
 ```
 
 To control the second motor instead, replace `motors[1]` with `motors[2]`.
 
 To stop both motors:
 
 ```python
+R.motors[0] = 0
 R.motors[1] = 0
-R.motors[2] = 0
 ```
 
 Here's a more complete example:
@@ -40,14 +40,14 @@ import robot
 R = robot.Robot()
 
 # set motor 1 to 60% power
-R.motors[1] = 60
+R.motors[0] = 60
 
 # set motor 2 to 60% power in the backwards direction
-R.motors[2] = -60
+R.motors[1] = -60
 
 # turn both motors off
+R.motors[0] = 0
 R.motors[1] = 0
-R.motors[2] = 0
 ```
 
 :::tip

docs/patching-the-robot.md

@@ -19,7 +19,7 @@ An important part of looking after your robot is making sure its software is up
 6. Select the patch file in the left-hand panel. The patch will show on the code view as Base64 encoded data (random-looking text). 
 7. Click the "Run" button (green arrow on the right-hand panel). 
 
-   ![](/images/run-button.png)
+   ![](/images/run-button.jpg)
 8. After a few moments, your BrainBox should reboot, and the LED will either turn off or remain on. You will lose connection with it while it does this. Do not turn off your BrainBox - the LED may stay off for up to a minute.
 9. The BrainBox LED will eventually start flashing again to show it has rebooted successfully. 
 10. If your PC has not automatically connected, connect to it using the WiFi. Once reconnected, refresh your browser and open a project from the left-hand side of the editor. Check that the patch version is correct in the right-hand panel.  

docs/servos.md

@@ -16,10 +16,10 @@ Servos are plugged into the **PWM** ports on the BrainBox. **PWM 1** represents
 You can control servos using the `servos` property of the `Robot` object. To set the first servo to the 50% position use:
 
 ```python
-R.servos[1] = 50
+R.servos[0] = 50
 ```
 
-To control the fourth servo instead, replace `servos[1]` with `servos[4]`.
+To control the fourth servo instead, replace `servos[0]` with `servos[3]`.
 
 Here's a more complete example:
 
@@ -29,14 +29,14 @@ import robot
 R = robot.Robot()
 
 # set servo 1 to the 50% position
-R.servos[1] = 50
+R.servos[0] = 50
 
 # set servo 3 to the -100% position
-R.servos[3] = -100
+R.servos[2] = -100
 
 # set servos 1 & 3 to the default positions
-R.servos[1] = 0
-R.servos[3] = 0
+R.servos[0] = 0
+R.servos[2] = 0
 ```
 
 ## Blockly
@@ -52,9 +52,9 @@ E.g. to set PWM1 to `100%` and PWM3 to `50%` use
 import robot
 
 servo_values = {
-    1: 100,
-    2: 50,
-    3: -100
+    0: 100,
+    1: 50,
+    2: -100
 }
 
 R = robot.Robot(servo_defaults=servo_values)