add second hole subsubsection and picture
[challenge-bot] / curriculum / challenge-bot.scm
index beefcb478d56110690adea9ffa0535f50fc85f6a..29b24eb0d0e8d63caf8453943a3961aca9c24241 100644 (file)
                         the screw?]))]))
     (subsubsection
      :title [fasten the arduino board to the deck]
-     (p [push the 6-32 screw into the deck from the underside and at the
-              same time, spin the 6-32 screw clockwise while looking
-              down on its head.
-              twist until the bottom of the screw is
-              about to stick out on the top side of the deck.])
+     (p [first we'll put the screw into the deck just enough so the deck
+               holds it in place.
+               then we will hold the arduino up to the screw and finish
+               tightening the screw down.
+               with the screw partially in, we do not have hold it as
+               rigidly while we are also holding the arduino and
+               the deck.])
+     (p [push the #6-32 screw into the deck from the underside.
+              the underside is the brown side.
+              at the same time, spin the 6-32 screw so it rotates
+              clockwise while looking down on its head.
+              twist until the tip of the screw is about to stick out on
+              the top side of the deck.])
      (p [hold the arduino board flat to the deck and line up the arduino
               hole so the screw can come up through it.
               continue tightening the screw into the deck, spinning the same
               tighten until the screw head touches the deck.
               do not continue tightening after that.])
      (p [the arduino should still be flat against the deck still, just
-             as it was before tightening the screw.]))
+             as it was before tightening the screw.])
+     (p [check
+         ,(itemize
+           (item [why do we insert the first screw partially before
+                      holding up the arduino?])
+           (item [which side of the deck is the top side?]))]))
     (subsubsection
-     :title [assessment]
-     (p [does the arduino stay with the deck when the deck moves?
-              can the arduino board still rotate a few degrees?
-              warning, if you rotate the arduino board too much, you
-              will unscrew it from the deck and you'll have to screw it
-              back in.
-              rotating a few degrees should be ok.]))
+     :title [assessment of the first screw]
+     (itemize
+      (item [,(bold [warning]), if you rotate the arduino board too
+             much,you will unscrew it from the deck and you'll have to
+             screw it back in.
+             rotating a few degrees should be ok.])
+      (item [does the arduino stay with the deck when the deck moves?])
+      (item [can the arduino board still rotate a few degrees?]))))
+   (subsection
+    :title [second hole and screw]
     (subsubsection
      :title [arduino board move relative to deck]
      (p [without any screws, the arduino board can move independently of
-                 the deck.])
-     (p [with the first screw, the arduino can rotate around one point
-              on the deck.])))
-   (subsection
-    :title [second hole and screw])
+                 the deck.
+                 it can translate and rotate freely.
+                 with the first screw, the arduino can rotate around one
+                 point on the deck and can no longer translate much.])
+     (p [the second screw limits rotation a lot.
+             it also makes translation even more difficult.
+             it might even be too small to be detectable by directly
+             looking at it.])
+     (p [to choose where the second hole and screw should go, we should
+            keep in mind that the goal is to attach the deck to the
+            arduino.
+            this means minimizing rotation and translation.
+            the picture below shows that the second hole should be as
+            far as possible from the first hole, since that minimizes
+            rotation.]
+        (figure :legend "arduino to deck / keep holes far apart"
+                (image :file "arduino-to-deck/keep-holes-far-apart.png")))))
    (subsection
     :title [third and fourth hole and screw]))
   (section