X-Git-Url: http://challenge-bot.com/repos/?a=blobdiff_plain;f=guide%2Fhausner%2F2016%2F08%2Foverview.org;h=0c16db9497a9465c60870604a77a5bc3b00fedbb;hb=d33bee8a268203f71190ca4808bfd973530cc4b2;hp=951eab349a85c54de108192af9ddb297a97444da;hpb=292841b7cb5366c85dcc64248ff552371e1f3fe4;p=challenge-bot

diff --git a/guide/hausner/2016/08/overview.org b/guide/hausner/2016/08/overview.org
index 951eab3..0c16db9 100644
--- a/guide/hausner/2016/08/overview.org
+++ b/guide/hausner/2016/08/overview.org
@@ -1,8 +1,11 @@
 #+TITLE:hausner challenge-bot overview
-#+SETUPFILE: org-html-themes/setup/theme-readtheorg.setup
+#+SETUPFILE: ../../org-html-themes/setup/theme-readtheorg.setup
 * assembling the hardware
-  go to the [[file:0-mechanical-assembly/mechanical-assembly.html][mechanical assembly]] page to see excruciating detail
+  first, go to the [[file:0-mechanical-assembly/mechanical-assembly.html][mechanical assembly]] page to see excruciating detail
   on how to put the mechanical parts together.
+* wiring
+  after the hardware is assembled, the robot is ready for wiring.
+  see the wiring page for the individual wiring steps.
 * software
   software is available as nice neat installable packages for
   Mac OS X, GNU+Linux, and MS Windows.
@@ -17,12 +20,13 @@
    its motors.
 
    https://www.arduino.cc/en/Main/Software
-** 3d modeling: openscad
+** part shaping: openscad
    create robot parts!
 
    use this program to view parts inside the "3d-printables"
-   directory.  write code to modify the parts and create completely
-   new ones.
+   directory of the class content.
+   there's a class content section below.
+   write code to modify the parts and create completely new ones.
 
    http://www.openscad.org/downloads.html
 ** wiring: fritzing
@@ -43,35 +47,36 @@
    with no extra software.
 
    http://7-zip.org/
-* class content
-  all the source code for the class is available here:
-
-  http://challenge-bot.com/repos/?p=challenge-bot;a=snapshot;h=232ff7a14f9d8be27362c268c6cdd1b67f59a24a;sf=tgz
-
-  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.
+** class content
+   all the source code for the class is available here:
+
+   http://challenge-bot.com/repos/?p=challenge-bot;a=snapshot;h=232ff7a14f9d8be27362c268c6cdd1b67f59a24a;sf=tgz
+
+   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.
+  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.
+  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.
+  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.
+  this will help you pinpoint exactly where the problem lies on your
+  robot.
+** TODO robot was working, but now is not