add check for arduino deck placement

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

diff --git a/curriculum/challenge-bot.scm b/curriculum/challenge-bot.scm
index 3aadc8d2596a71d744053faca63326131bd2f3ab..15ea4e00f96688f15b856dac3faf8d649757ac1b 100644 (file)
--- a/curriculum/challenge-bot.scm
+++ b/curriculum/challenge-bot.scm
@@ -5,6 +5,7 @@
  :title [challenge-bot]
  (chapter
   :title [mechanical]
+  (p [let's build your robot!])
   (section
    :title [arduino to deck]
    (p [let's attach the arduino to the deck.])
@@ -21,27 +22,41 @@
               (item [alan wrench])
               (item [wood block])
               (item [arduino])
-              (item [#6-32x3/8\", four of them]))]))
+              (item [#6-32x3/8\", four of them])
+              (item [robot deck, the white thing with a grid of holes1]))]))
    (subsection
     :title [first hole]
     (subsubsection
      :title [choosing drill bit]
-     (p [choosing the right drill bit depends on what job you are doing.
-                  right now, we are making holes for screws to hold the
-                  arduino to the deck.
-                  this means the hole needs to be big enough for the
-                  screw body to fit through.
-                  we want the screw to stay put once it's in place.
-                  we also want the drill bit to be smaller than the
-                  diameter of the thread.
-                  the screw was chosen so that the hole on the arduino
-                  was bigger than the body and smaller than the thread.
-                  we will choose the biggest drill bit that fits through
-                  the hole on the arduino.])
+     (p [the arduino comes with holes in it already, so we will make
+             some choices around those holes.
+             choosing the right drill bit depends on what job you are
+             doing.
+             right now, we are making holes for screws to hold the
+             arduino to the deck.
+             there are two constraints between the hole and screw.
+             each hole needs to be big enough for the screw body to fit
+             through it.
+             the holes also need to be smaller than the screw's thread.
+             since there are holes on the arduino already, the screw was
+             chosen to match it.
+             the screw was chosen so that the hole on the arduino was
+             bigger than the screw body and smaller than its thread.
+             we will choose the biggest drill bit that fits through the
+             hole on the arduino, then use that to drill holes in the
+             deck.])
      (p [here's a cross section of a screw in the deck]
         (figure :legend "screw cross section"
                 (image :file
-                       "arduino-to-deck/screw-cross-section.png"))))
+                       "arduino-to-deck/screw-cross-section.png")))
+     (p [check
+         ,(itemize
+           (item
+            [what would happen if the drill bit were larger than the
+                  screw thread?])
+           (item
+            [what would happen if the drill bit were smaller than the
+                  screw body?]))]))
     (subsubsection
      :title [inserting drill bit]
      (p (figure :legend "arduino to deck / insert bit"
@@ -55,7 +70,14 @@
         [while holding the drill bit, twist end of the drill to tighten
                the teeth.
                make sure that the teeth end up gripping the flat part of
-               the drill bit.]))
+               the drill bit.])
+     (p [check
+         ,(itemize
+           (item
+            [where should the teeth clamp down on the drill bit?])
+           (item
+            [what would happen if the teeth tightened on the recessed
+                  part of the drill bit?]))]))
     (subsubsection
      :title [holding drill]
      (p [hold the drill with one hand on the handle and trigger.
@@ -78,7 +100,16 @@
              the green circle shows where the hole is.
              the blue box encloses the arduino hole and two deck holes.
              place the arduino hole mid-way between the two
-             deck holes.]))
+             deck holes.])
+     (p [check
+         ,(itemize
+           (item
+            [should the arduino be upside-down?])
+           (item
+            [what should the upper side of the arduino align with?])
+           (item
+            [why not place the arduino up along the left side of the
+                 robot?]))]))
     (subsubsection
      :title [drilling]))
    (subsection