start numbering guide at 0

[challenge-bot] / guide / challenge-bot.scm

diff --git a/guide/challenge-bot.scm b/guide/challenge-bot.scm
index da614d50dfe9b505dba0c5faaee74a4fed9cebf6..993880cf58673bd8fe2723b2fd47c38dc49944b4 100644 (file)
--- 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]
@@ -565,24 +568,53 @@
              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 [wheels]
-   (subsection
-    :title [tread])
-   (subsection
-    :title [motor]))
   (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