X-Git-Url: http://challenge-bot.com/repos/?a=blobdiff_plain;f=guide%2Fhausner%2Foverview.org;h=c094de5e8a96b48a7f1ba0cd5d98654c7d1871f3;hb=0d77067afcdee3acb889a063ac759381b43f6b6e;hp=8a50e2ac76cf7fc591704b81a32f08ae634a4240;hpb=4b330805ea3085648be39522836dac6ead31685d;p=challenge-bot

diff --git a/guide/hausner/overview.org b/guide/hausner/overview.org
index 8a50e2a..c094de5 100644
--- a/guide/hausner/overview.org
+++ b/guide/hausner/overview.org
@@ -1,32 +1,61 @@
+#+TITLE:hausner challenge-bot overview
 * challenge-bot robot overview
 ** videos for assembling the hardware
-** content
-*** software
-    software is available as nice neat installable packages for
-    Mac OS X, GNU+Linux, and MS Windows.
-
-    it's also available in source code form, so you can compile it for
-    other platforms.
-
-    all software used in this robot is available for you to use for any
-    purpose, improve, and, share those improvements (if you want).
-**** arduino
-***** summary
-      control how the robot gets information from sensors, and moves
-      its motors.
-***** download
-      https://www.arduino.cc/en/Main/Software
-**** openscad
-***** summary
-      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.
-***** download
-      http://www.openscad.org/downloads.html
-**** fritzing
-***** summary
-      wire up components!
-***** download
-      http://fritzing.org/download/?donation=0
+** software
+   software is available as nice neat installable packages for
+   Mac OS X, GNU+Linux, and MS Windows.
+
+   it's also available in source code form, so you can compile it for
+   other platforms.
+
+   all software used in this robot is available for you to use for any
+   purpose, improve, and, share those improvements (if you want).
+*** arduino
+**** summary
+     control how the robot gets information from sensors, and moves
+     its motors.
+**** download
+     https://www.arduino.cc/en/Main/Software
+*** openscad
+**** summary
+     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.
+**** download
+     http://www.openscad.org/downloads.html
+*** fritzing
+**** summary
+     wire up components!
+**** download
+     http://fritzing.org/download/?donation=0
+*** 7-zip
+**** summary
+     extract the contents of .tgz files, like the content of this class.
+
+     this is needed on MS Windows(tm) only.
+
+     if you are on Mac OS X, or GNU (on cygwin or linux), then you do
+     not need this.  your software will be able to extract the
+     class content
+**** download
+     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.