review comments - brain board

Author: 8BitJosh

_data/sidebar_tree.yaml

@@ -38,8 +38,8 @@ tree:
     - url: /programming/robot_api/
       title: Robot API
       tree:
-      - url: /programming/robot_api/metadata
-        title: Metadata
+      - url: /programming/robot_api/comp_mode
+        title: Competition Mode
     - url: /programming/leds
       title: Brain Board LED API
     - url: /programming/motors
@@ -105,7 +105,7 @@ tree:
     - url: /tutorials/using_the_simulator
       title: Using the simulator
     - url: /tutorials/update_brain
-      title: How to update your robot
+      title: Updating your brain board
   - url: /competitor_resources/
     title: Resources
     tree:

kit/brain_board/robot_os.md

@@ -7,6 +7,7 @@ title: Student Robotics OS
 # Student Robotics OS
 
 The Raspberry Pi runs a custom operating system that contains the Student Robotics software.
+It's based on [Raspberry Pi OS](https://www.raspberrypi.com/documentation/computers/os.html) (`2023-05-03`).
 The OS contains a set of pre-installed python libraries that you can use, the list of which can be found [here](./python_libraries).
 
 

kit/brain_board/wifi.md

@@ -19,9 +19,9 @@ It will initially have a name starting with `robot-ZZZ` followed by some random
 You can now connect to your robot in the same way you normally connect to a WiFi network.
 You will need a WiFi key to be able to connect and you can find this inside `robot-settings.toml` on the USB drive containing your code.
 
-<div class="info">
-    If there is no <code>robot-settings.toml</code> on your USB drive, you can generate one by first running any code on your robot.
-    For more information see our docs on <a href="{{ site.baseurl }}/kit/brain_board#robot-settings">Robot Settings</a>.
+<div class="info" markdown="1">
+If there is no `robot-settings.toml` on your USB drive, you can generate one by first running any code on your robot.
+For more information see our docs on [Robot Settings]({{ site.baseurl }}/kit/brain_board#robot-settings).
 </div>
 
 These details can also be printed using:
@@ -57,3 +57,4 @@ Changing the starting zone allows you to test how your robot handles being start
 Changing mode applies from the next time your code runs.
 
 The WiFi interface will only be fully accessible when your robot is started in dev mode and will be restricted in competition mode.
+See the [competition mode]({{ site.baseurl }}/programming/robot_api/comp_mode) page for details of what competition mode is and what limitations it imposes.

programming/robot_api/comp_mode.md

@@ -0,0 +1,8 @@
+---
+layout: page
+title: Competition Mode
+---
+
+# Competition Mode
+
+TODO

programming/robot_api/metadata.md

@@ -1,6 +1,6 @@
 ---
 layout: page
-title: How to update your robot
+title: Updating your brain board
 ---
 
 {% comment %}
@@ -11,8 +11,7 @@ The below will automatically calculate the latest version number, to be used whe
 {% assign latest_version = latest_version.version %}
 
 
-How to update your robot
-========================
+# Updating your brain board
 
 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.