add troubleshooting section

[challenge-bot] / guide / hausner / overview.org

diff --git a/guide/hausner/overview.org b/guide/hausner/overview.org
index 49773408a447f4eba30e707104f1e9d90a620df3..b73f7283dd07ac04ccab11da4e3638e5362606f3 100644 (file)
--- a/guide/hausner/overview.org
+++ b/guide/hausner/overview.org
@@ -48,3 +48,28 @@
 
    what follows is a high level description of the contents of the most
    important top level directories in the class content.
+*** 3d-printables
+    the parts of the robot that are 3d-printed are in this directory.
+    use openscad to open the parts in this directory.
+*** build-stages
+    all the wiring diagrams and arduino code live in this directory.
+
+    under this directory, there is one subdirectory for each
+    build stage.
+    each build stage is prefixed with a letter to make it appear in
+    order.
+    for example, =a_serial= contains the first build stage.
+** troubleshooting
+    to troubleshoot a misbehaving robot, go through these stages
+    in order until you find a stage that does not work correctly.
+
+    first, in =a_serial=, you'll check whether the arduino can
+    communicate over the serial connection with the computer.
+
+    in each stage, make sure the wires shown in the fritzing
+    diagram are correctly connected on your robot.
+    then load the corresponding arduino sketch to your robot
+    and either check the serial monitor, or turn on the motor battery.
+
+    this will help you pinpoint exactly where the problem lies on your
+    robot.