add questions for stages

[challenge-bot] / guide / questions.scm

;; tldr; AGPLv3+
;; copyright info at bottom

(document
 :title [challenge-bot]
 (chapter
  :title [mechanical]
  (section
   :title [arduino to deck]
   (subsection
    :title [first hole]
    (subsubsection
     :title [choosing drill bit]
     (p [check])
     (enumerate
      (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 [check])
     (enumerate
      (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 [arduino placement]
     (p [check])
     (enumerate
      (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 practice]
     (p [check])
     (enumerate
      (item
       [should the drill be at full speed while the drill bit is
               going down into the wood and coming back up?])
      (item
       [how do you keep the drill at full speed?])
      (item
       [what would happen if the drill bit were not at full
             speed?])
      (item
       [what would happen if the drill were twisted sideways while
             the drill bit were in the wood?]))))
   (subsection
    :title [first screw]
    (subsubsection
     :title [fastening arduino to deck using #6-32x3/8\" screw]
     (p [check])
     (enumerate
      (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 [check])
     (enumerate
      (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?])
      (item [what part of the screw does the screw driver go into?])))
    (subsubsection
     :title [fasten the arduino board to the deck]
     (p [check])
     (enumerate
      (item [why do we insert the first screw partially before
                 holding up the arduino?])
      (item [which side of the deck is the top side?])))))
  (section
   :title [breadboard]
   (p [check])
   (enumerate
    (item [should the black chip be on the right or the left?])
    (item [how many glue dots should be on the breadboard?])))
  (section
   :title [battery packs]
   (subsection
    :title [leads]
    (subsubsection
     :title [strip]
     (p [check])
     (enumerate
      (item [should you pick up a battery by its leads?])
      (item [should you strip the leads a large amount at a time?])
      (item [what's the name of wires made of a bunch of tiny
                    wires?])))
    (subsubsection
     :title [wrap]
     (p [check])
     (enumerate
      (item [why are we using a solid core wire?])))
    (subsubsection
     :title [solder]
     (p [check])
     (enumerate
      (item [should the wires melt the solder?])
      (item [why should we clean off the tip of the soldering iron?])
      (item [why do we put more solder back on the tip of the iron?]))))
   (subsection
    :title [deck attachment]
    (subsubsection
     :title [motor battery pack attachment]
     (p [check])
     (enumerate
      (item [why place the glue dots on the side of the battery pack
                 without the on/off switch?])))
    (subsubsection
     :title [arduino battery pack attachment]
     (p [check])
     (enumerate
      (item [why align the screw with a hole on the deck?])))))
  (section
   :title [motors]
   (subsection
    :title [leads]
    (p [check])
    (enumerate
     (item [should the electrical tape go between the wires and the
                   metal band?])
     (item [are the motor tabs strong?])
     (item [what are we doing to reinforce the motor tabs mechanically?])
     (item [does hot glue make an electrical connection?])))
   (subsection
    :title [motor mount]
    (subsubsection
     :title [angle bracket to motor mount]
     (p [check])
     (enumerate
      (item [should the motor mounts have angle brackets attached in
                    a mirror image fashion?])
      (item [why should the motor mounts have angle brackets attached in
                 a mirror image fashion?])))
    (subsubsection
     :title [motor mount to motor]
     (p [check])
     (enumerate
      (item [is the #4 bolt thicker or thinner than the #6?])
      (item [do you have a ratcheting socket wrench, or not?]))))
   (subsection
    :title [deck attachment]))
  (section
   :title [caster]
   (p [check])
   (enumerate
    (item [what would happen if the robot did not have a caster?])))
  (section
   :title [wheels]
   (p [check])
   (enumerate
    (item [does the robot's wheels scrape the deck?])
    (item [what would happen if the robot had no wheels?])
    (item [what does the tread do?])
    (item [what is  the tread?])
    (item [what kind of screw is used?])))
  (section
   :title [sonars]
   (p [check])
   (enumerate
    (item [are your sonar sensors pointy pins facing in toward the
               arduino?])
    (item [was it difficult to get the sonar into the holder?])
    (item [what would happen if it was easy to slip the sonar sensor
                into the sonar holder?])))))

;; Copyright 2016 daniel watson

;; This file is part of challenge-bot.

;; challenge-bot is free software: you can redistribute it and/or modify
;; it under the terms of the GNU Affero General Public License as
;; published by the Free Software Foundation, either version 3 of the
;; License, or (at your option) any later version.

;; challenge-bot is distributed in the hope that it will be useful,
;; but WITHOUT ANY WARRANTY; without even the implied warranty of
;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
;; GNU Affero General Public License for more details.

;; You should have received a copy of the GNU Affero General Public
;; License along with challenge-bot.  If not, see
;; <http://www.gnu.org/licenses/>.