+ :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.
+ 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
+ :title [holding drill])
+ (subsubsection
+ :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]
+ (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
+ :title [first screw]
+ (subsubsection
+ :title [fastening arduino to deck using #6-32x3/8\" screw]
+ (p [the "#6" part of "#6-32x3/8\"" is how big around the bolt is.
+ it is related to wire gauge.
+ bigger numbers mean larger screw.
+ smaller numbers means smaller screws.])
+ (p [check
+ ,(itemize
+ (item
+ [in the motor assembly, there are #4-40x1.25\" screws.
+ are those fatter, thinner, or the same thickness as the
+ #6-32x3/8\" screws?]))])
+ (p [the "32" part is a measurement of how close the threads are to
+ each other.
+ this is related to the angle of the thread, which is also
+ called pitch.
+ it is a count of how many times the thread wraps around one
+ inch of the screw body.])
+ (p [the head is the flat part where some tool, like the alan
+ wrench, can exert force to spin the screw.])
+ (p [check
+ ,(itemize
+ (item [how many times will the thread wrap around one inch of
+ the screw body?])
+ (item [what about 2 inches?
+ how many times will the thread wrap around two
+ inches of the screw body?]))]))
+ (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 [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
+ direction as before.
+ 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.]))
+ (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.]))
+ (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.])))