X-Git-Url: http://challenge-bot.com/repos/?p=challenge-bot;a=blobdiff_plain;f=guide%2Fchallenge-bot.scm;h=993880cf58673bd8fe2723b2fd47c38dc49944b4;hp=0d2a7eee854db108f0bc86e81ff086cf2c857f65;hb=56fffacb9f19444f6ab08e02114514d543208db3;hpb=42d5aff2676a2ccc33f91ee1f427afdb80df3a01

diff --git a/guide/challenge-bot.scm b/guide/challenge-bot.scm
index 0d2a7ee..993880c 100644
--- a/guide/challenge-bot.scm
+++ b/guide/challenge-bot.scm
@@ -3,11 +3,14 @@
 
 (document
  :title [challenge-bot]
+ (toc)
  (chapter
   :title [mechanical]
+  :number "0"
   (p [let's build your robot!])
   (section
    :title [arduino to deck]
+   :number "0"
    (p [let's attach the arduino to the deck.])
    (subsection
     :title [required materials]
@@ -553,25 +556,65 @@
       (item [is the #4 bolt thicker or thinner than the #6?])
       (item [do you have a ratcheting socket wrench, or not?]))))
    (subsection
-    :title [deck attachment]))
-  (section
-   :title [wheels]
-   (subsection
-    :title [tread])
-   (subsection
-    :title [motor]))
+    :title [deck attachment]
+    (p [now that the motor assemblies are together, we will attach them
+            to the deck.])
+    (figure
+     :legend "motor / motor assembly to deck"
+     (video
+      :file "3-motor-assemblies/2-motor-assembly-to-deck.ogv"))
+    (p [when attaching the motor assembly to the deck, be sure to push
+             the assembly as far outward from the center of the robot
+             as you can while tightening it down.
+             this will give more clearance to the wheels of the robot
+             so they do not rub the deck.])))
   (section
    :title [caster]
-   (subsection
-    :title [deck placement]))
+   (p [the caster will go at the back of the robot and provide a third
+           point of contact for the robot, making it easier for it to
+           balance.])
+   (figure
+    :legend "caster"
+    (video :file "4-caster-to-deck.ogv"))
+   (p [check])
+   (enumerate
+    (item [what would happen if the robot did not have a caster?])))
+  (section
+   :title [wheels]
+   (p [now we will attach the wheels.
+           this makes the motor movement transform into robot movement!])
+   (figure
+    :legend "wheel"
+    (video :file "5-wheel-to-robot-assembly.ogv"))
+   (p [check])
+   (enumerate
+    (item [does the robot's wheels scrape the deck?])
+    (item [what would happen if the robot had no wheels?])
+    (item [what does the tread do?])
+    (item [what is  the tread?])
+    (item [what kind of screw is used?])))
   (section
    :title [sonars]
-   (subsection
-    :title [deck placement])))
+   (p [we are almost done with mechanical assembly!
+          this next step is to add the sonar sensors to the robot.
+          sonar sensors are what the robot uses to detect distances.
+          it sends out a signal, then listens for a response and
+          keeps track of how long it takes.])
+   (figure
+    :legend "sonar sensors"
+    (video :file "6-sonar-sensors-to-deck.ogv"))
+   (p [check])
+   (enumerate
+    (item [are your sonar sensors pointy pins facing in toward the
+               arduino?])
+    (item [was it difficult to get the sonar into the holder?])
+    (item [what would happen if it was easy to slip the sonar sensor
+                into the sonar holder?]))))
  (chapter
   :title [wiring and software]
   (section
    :title [serial]
+   :number "0"
    (subsection
     :title [software on computer]
     (subsubsection