add questions for stages
[challenge-bot] / guide / questions.scm
diff --git a/guide/questions.scm b/guide/questions.scm
new file mode 100644 (file)
index 0000000..1407457
--- /dev/null
@@ -0,0 +1,194 @@
+;; 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/>.