Merge branch 'simulator-updates'

Author: PeterJCLaw

programming/sr/leds/index.md

@@ -6,6 +6,10 @@ title: LEDs
 LEDs
 ====
 
+<div class="info">
+This documentation refers to a feature which is only available on the physical robot kits.
+</div>
+
 The KCH HAT provides diagnostic information about the state of your robot
 through a collection of preconfigured and user-controllable LEDs. It is part of
 the [Brain Board](/docs/kit/brain_board) assembly, however control of its LEDs

programming/sr/servos/index.md

@@ -6,10 +6,6 @@ title: Servos
 Servos
 ======
 
-<div class="info">
-This documentation refers to a feature which is only available on the physical robot kits.
-</div>
-
 The `servo_board` object is used to control a collection of Servo Boards.
 
 When a single Servo Board is connected to your robot, you can control it

programming/sr/vision/index.md

@@ -6,10 +6,6 @@ title: Vision
 Vision
 ======
 
-<div class="info">
-This documentation refers to a feature which is only available on the physical robot kits.
-</div>
-
 The `sr.robot3` library contains support for detecting fiducial markers with the provided webcam.
 Markers are attached to various items in the Student Robotics arena.
 Each marker encodes a number in a machine-readable way, which means that robots can identify these objects.
@@ -168,6 +164,11 @@ A `ThreeDCoordinate` object contains an `x`, `y` and `z` attribute. The exact me
 [`Orientation`](#Orientation) {#Orientation}
 ---------------
 
+<div class="info">
+Orientation information is returned in different formats between the simulator and the physical robot kits.
+One (possibly both) of them may change to resolve this.
+</div>
+
 An `Orientation` object describes the orientation of a marker.
 
 ![A visual representation of how the orientation axes work. Source: SourceBots]({{ site.baseurl }}/images/content/vision/yaw-pitch-roll.png)

simulator/programming/index.md

@@ -32,7 +32,8 @@ Your code should be developed in `robot.py`.
 There is a pre-built robot used in the simulator.
 To allow this simulated robot to move around and sense its environment a set of motors and sensors have been connected as detailed below.
 
-The simulator’s API is very similar to the real SR API described in the [programming docs]({{ site.baseurl }}/programming/), with the exception of `R.time` and `R.sleep`.
+The simulator’s API is very similar to the real SR API described in the [programming docs]({{ site.baseurl }}/programming/).
+The main differences are the way that [time is handled](#simulated-time), some discrepancies in the vision API we hope to resolve soon and the simulated robot not having the Brain Board LEDs.
 
 <div class="info">
   To more closely reflect reality, artificial noise has been added to simulated