split figures into separate paragraphs

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

diff --git a/curriculum/challenge-bot.scm b/curriculum/challenge-bot.scm
index 63aa0d0cd2d6d5dcb5d3c1642e47bc3d735c551c..2284e0e24a4be0b49c809d3ee24b41fe42b1bbc3 100644 (file)
--- 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,17 @@
    (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.
+                  the threads of the screw will grip the edges of the
+                  hole it's going through.])
+     (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,14 +43,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"))
-        [the top edge of the arduino should line up with the underside
-             of the 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/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 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