X-Git-Url: http://challenge-bot.com/repos/?a=blobdiff_plain;f=curriculum%2Fchallenge-bot.scm;h=933c0fa080c8e7150f82b11019ddb8be349c0352;hb=8923a50f4be8b08a57995352f6ad5209990c49d0;hp=2364250c7785f1185ecba9fa10116fee369ff18b;hpb=8cf33cb7b341d72162565d7cef10917a8747810e;p=challenge-bot

diff --git a/curriculum/challenge-bot.scm b/curriculum/challenge-bot.scm
index 2364250..933c0fa 100644
--- a/curriculum/challenge-bot.scm
+++ b/curriculum/challenge-bot.scm
@@ -11,7 +11,7 @@
     :title [required materials]
     (p [you will need the things in this picture.
             ,(figure :legend "arduino to deck / required materials"
-                    (image :file "arduino-to-deck/0-required-materials.png"))
+                     (image :file "arduino-to-deck/0-required-materials.png"))
             ,(itemize
               (item [medical kit with bandages])
               (item [safety goggles])
@@ -24,7 +24,21 @@
    (subsection
     :title [first hole]
     (subsubsection
-     :title [choosing drill bit])
+     :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 [here's a diagram of a screw]
+        (figure :legend "screw" (image :file "arduino-to-deck/screw.png"))))
     (subsubsection
      :title [inserting drill bit])
     (subsubsection
@@ -33,18 +47,20 @@
      :title [arduino placement]
      (p [the arduino should be placed as shown in this picture.]
         (figure :legend "arduino to deck / place arduino"
-                (image :file "arduino-to-deck/3-place-arduino.png"))
-        [here's a closeup]
+                (image :file "arduino-to-deck/3-place-arduino.png")))
+     (p [here's a closeup]
         (figure :legend "arduino to deck / place arduino closeup"
-                (image :file "arduino-to-deck/4-place-arduino-closeup.png"))
-        [the arduino should line up with the holes on the deck.
-             place the arduino's top edge along the underside of the
-             deck's holes closest to the edge of the deck.
-             on the arduino, there's a hole on the top left.
-             that hole should be mid-way between two of the holes in the
-             grid of holes on the deck.
-             put the arduino hole between the third and fourth holes
-             from the left side of the deck.]))
+                (image :file
+                       "arduino-to-deck/4-place-arduino-closeup.png"))
+        [the picture above shows where to place the arduino on the deck.
+             the arduino should line up with the holes on the deck.
+             this alignment line is highlighted in pink.
+             on the arduino, there's a hole on the top left, between the
+             orange reset button and black headers.
+             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.]))
     (subsubsection
      :title [drilling]))
    (subsection