proofreading + updated TODO

jeffchang0 · jeffchang0 · commit ddeb7629f017 · 2025-05-09T02:09:06.000-04:00
diff --git a/docs/_sections/_guide-home/forms.md b/docs/_sections/_guide-home/forms.md
@@ -5,7 +5,7 @@ nav_include: true
 nav_order: 5
 ---
 
-# Links and Formsaaa
+# Links and Forms
 
 This page contains direct links and forms that you might need for Robotathon!
 
diff --git a/docs/_sections/_guide-home/schedule.md b/docs/_sections/_guide-home/schedule.md
@@ -8,10 +8,10 @@ nav_order: 4
 # Competition Schedule
 
 This calendar will have the most up to date version of the competition timeline!
-<iframe src="https://calendar.google.com/calendar/embed?src=1e8b00794a07180514fdc54c5b78dca70637bc1a8a72076e64dc787ebe2a71cb%40group.calendar.google.com&ctz=America%2FChicago" style="border: 0" width="800" height="600" frameborder="0" scrolling="no"></iframe>
+<iframe src="https://calendar.google.com/calendar/embed?src=9a08dd3dac1df5c210999c130b7e69ccc35d1f88f91902aa3ff64ee9daa4aa3b%40group.calendar.google.com&ctz=America%2FChicago" style="border: 0" width="800" height="600" frameborder="0" scrolling="no"></iframe>
 
 {: .highlight}
 Tip: You can add this calendar to your personal Google calendar by clicking the plus button above^^
 {: .callout-blue}
 
-Here is the [RAS office hours schedule](https://docs.google.com/spreadsheets/d/1MNuk1WAB5ZmVcOo-_wdnVN3yREhI9oH90169OuW2QAc/edit?gid=1317822740#gid=1317822740) You may go to any of the office hours that you please, but note that office hours are subject to change throughout the semester.
+Here is the [RAS office hours schedule](https://docs.google.com/spreadsheets/d/132Lb-cNybgYhRVPhrrf0xoe3HGi9ErQ2J2lOkMYBeXc/edit?gid=0#gid=0) You may go to any of the office hours that you please, but note that office hours are subject to change throughout the semester.
diff --git a/docs/_sections/_guide-home/welcome.md b/docs/_sections/_guide-home/welcome.md
@@ -14,7 +14,7 @@ nav_order: 3
 
 This guide aims to provide you with helpful information and direction throughout your robot building process. While this guide is broad, it stays mostly within the realm of setup and basic tips since we encourage you to discover your own solutions.
 
-If you have any technical questions or don’t understand a topic, ask the mentors or during [TODO: link office hours here]()! We can help to resolve your problems, or point you to the right person who can. Mentors, office hours, and other teammates are valuable resources to turn to if you are stuck.
+If you have any technical questions or don’t understand a topic, ask the mentors during [office hours](https://docs.google.com/spreadsheets/d/132Lb-cNybgYhRVPhrrf0xoe3HGi9ErQ2J2lOkMYBeXc/edit?gid=0#gid=0)! We can help to resolve your problems, or point you to the right person who can. Mentors, office hours, and other teammates are valuable resources to turn to if you are stuck.
 
 ## Overview
 
diff --git a/docs/_sections/_guide-primaries/designing-a-robot/designing-a-robot.md b/docs/_sections/_guide-primaries/designing-a-robot/designing-a-robot.md
@@ -5,5 +5,5 @@ nav_include: true
 has_children: true
 nav_order: 3
 ---
-
+# How do I put it all together?
 <!-- this file is for the section drop down bar -->
diff --git a/docs/_sections/_guide-primaries/designing-a-robot/sensor-and-actuator-placement.md b/docs/_sections/_guide-primaries/designing-a-robot/sensor-and-actuator-placement.md
@@ -32,5 +32,5 @@ Illustrated below is a sample configuration:
 <img src="{{ '/_assets/images/line_and_color.png' | prepend: site.baseurl }}" alt="line_and_color.png :(" >
 
 ## Actuators
-"Actuators" is just a fancy name for motors or anything that enables some kind of movement for your robot. You will need at least two of these with a castor ball to have a moving base. While you have full creative reign on where to put your actuators to achieve motion and solve the mechanical challenge, it will be important to consider where to place your wheel actuators since they will affect how your robot drives and, (arguably) most importantly, turns.
+"Actuators" is just a fancy name for motors or anything that enables some kind of movement for your robot. You will need at least two of these with a caster ball to have a moving base. While you have full creative reign on where to put your actuators to achieve motion and solve the mechanical challenge, it will be important to consider where to place your wheel actuators since they will affect how your robot drives and, (arguably) most importantly, turns.
 
diff --git a/docs/_sections/_guide-primaries/getting-started/bluepad.md b/docs/_sections/_guide-primaries/getting-started/bluepad.md
@@ -10,7 +10,7 @@ nav_order: 6
 
 You will be connecting a game controller to your ESP32 for controlling your robot (i.e. triggering autonomous modes, moving between challenges, and firing your launching mechanism)
 
-That being said, you will not be allowed to manually drive your robot through the challenges, as that defeats the purpose of having the sensors.
+That being said, you will not earn points for manually driving your robot through the challenges, as that defeats the purpose of having the sensors.
 
 It is highly recommended that you program specific functions of the sensors (line, color, distance) to specific buttons on the remote controller so that you have more control over your robot's behavior (i.e. press A -> color autonomy mode, press B -> exit to normal drive mode).
 
diff --git a/docs/_sections/_guide-primaries/getting-started/getting-started.md b/docs/_sections/_guide-primaries/getting-started/getting-started.md
@@ -5,5 +5,5 @@ nav_include: true
 has_children: true
 nav_order: 2
 ---
-
+# How do I get started on my robot?
 <!-- this file is for the section drop down bar -->
diff --git a/docs/_sections/_guide-primaries/getting-started/git.md b/docs/_sections/_guide-primaries/getting-started/git.md
@@ -6,7 +6,7 @@ parent: Getting Started
 nav_order: 5
 ---
 
-# How to use Git
+# How to use Git:
 
 ## What is Git?
 **Git** is a tool used for source/version control, which is the process of tracking changes to files over time.
@@ -33,7 +33,10 @@ Note that Robotathon aims to give you a *basic* understanding of how Git/GitHub
 1. Run `git commit -m "message here"` (keep quotes) to **commit** your change to your *local* repository [(What is the `-m`?)](todo LINK to how to use git bash in faq)
 1. Run `git push` to write your changes to the *remote* repository on GitHub
 
+
+{: .highlight}
 TODO add picture
+{: .callout-red}
 
 ## What is staging in Git?
 Instead of having to push every little change to your repository, you can group them into a collection of changes called a **commit**, which serve as a snapshot of the project's state.
diff --git a/docs/_sections/_guide-primaries/getting-started/microcontroller-interface.md b/docs/_sections/_guide-primaries/getting-started/microcontroller-interface.md
@@ -21,8 +21,8 @@ We are only concerned with pins that are power, ground, GPIO, and ADC enabled, s
 * ADC (Analog to Digital Converter) - only some pins. These pins can read analog values instead of just high or low. 
 
 {: .highlight}
-Warning: Be careful to not short (connect) a power pin directly to a ground pin. This will fry your ESP32 and more by causing a huge surge of current. 
-{: .callout-blue}
+Warning: Be careful to not short (connect) a power pin directly to a ground pin. This will fry your ESP32 and more by causing a huge surge of current (not good). 
+{: .callout-red}
 
 ## Powering the ESP32
 You can power your ESP32 by 2 methods: battery pack or laptop USB connection.
diff --git a/docs/_sections/_guide-primaries/sensors-and-actuators/actuators.md b/docs/_sections/_guide-primaries/sensors-and-actuators/actuators.md
@@ -109,7 +109,7 @@ Again, more detailed information about the L298N motor controllers can be [found
 
 ## What Are Servos?
 
-Servos are motors that are designed for precise position control. Instead of freely rotating when powered, servos listen to a control signal (usually [PWM](https://learn.sparkfun.com/tutorials/pulse-width-modulation/all)) to determine where to rotate. Some servos offer limited rotation, while others can rotate continuously (like ours).More advanced servos have other ways to be even more precise such as a feedback system on top of the control signal, but that is not necessary for this competition.
+Servos are motors that are designed for precise position control. Instead of freely rotating when powered, servos listen to a control signal (usually [PWM](https://learn.sparkfun.com/tutorials/pulse-width-modulation/all)) to determine where to rotate. Some servos offer limited rotation, while others can rotate continuously (like ours). More advanced servos have other ways to be even more precise such as a feedback system on top of the control signal, but that is not necessary for this competition.
 
 ## How to Use Servos?
 
diff --git a/docs/_sections/_guide-primaries/sensors-and-actuators/color-sensors.md b/docs/_sections/_guide-primaries/sensors-and-actuators/color-sensors.md
@@ -27,7 +27,7 @@ The APDS-9960 Color Sensor will allow you to complete the Color Challenge.
 ## How it Works
 The RGB (Red Green Blue) sensor has an infrared LED light that detects color by emitting light and detecting with four photodiodes the reflected light. The photodiodoes are each filtered to sense the Red, Green, Blue, and Clear color components. The RGB provides the R G and B data in integer values of 0-255 (8 bit representation). We will grab that data using a communication protocol called I2C (Inter-integrated circuit), which is used in many electrical devices. Implementing I2C is out of the scope of this competition, but you can find more information about it [here.](https://learn.sparkfun.com/tutorials/i2c/all)
 
-For the competition, you will want to make sure you understand the RGB sensor also detect ambient light levels andd proximity, so make sure your color sense is placed appropriately to successfully complete the color challenge.
+For the competition, you will want to make sure you understand the RGB sensor also detect ambient light levels and proximity, so make sure your color sense is placed appropriately to successfully complete the color challenge.
 
 If you want more details on how the color sensor works, check out [this link!](https://www.utmel.com/components/everything-you-know-about-tcs34725-color-sensors-faq?id=1986)
 
diff --git a/docs/_sections/_guide-primaries/sensors-and-actuators/hardware.md b/docs/_sections/_guide-primaries/sensors-and-actuators/hardware.md
@@ -5,5 +5,5 @@ nav_include: true
 has_children: true
 nav_order: 2
 ---
-
+# What do all of these parts do?
 <!-- this file is for the section drop down bar -->
diff --git a/docs/_sections/_guide-primaries/sensors-and-actuators/ir-sensors.md b/docs/_sections/_guide-primaries/sensors-and-actuators/ir-sensors.md
@@ -29,7 +29,7 @@ There are 3 pins (red, black, white) to the device as seen in the picture, assoc
 
 
 {: .highlight}
-Note that our IR sensors have reversed cable adapters with **incorrect** color coding (red actually corresponds to GND, and black actually corresponds to +5V). If you plug the power in backwards, you will fry the sensor!
+Note that our IR sensors have reversed cable adapters with **incorrect** color coding (red actually corresponds to GND, and black actually corresponds to +5V). If you plug the power in backwards, you will fry the sensor! (still holds with new wire order?)
 {: .callout-blue}
 
 |  IR Sensor Pin   | ESP32 Pin          |
diff --git a/docs/_sections/_guide-primaries/sensors-and-actuators/sensor-integration.md b/docs/_sections/_guide-primaries/sensors-and-actuators/sensor-integration.md
@@ -19,7 +19,7 @@ Unfortunately, there are no easy answers to these questions. Your best bet is to
 * If not, then I am off the line and should correct slightly by:
  * Driving one wheel faster than the other.
  * Stopping and rotating the robot until I find the line again.
- * Etcetera …
+ * Et cetera …
 
 Test each intuition to see if it makes sense! Eventually, your intuitions will build a representative model of the world and how to traverse it.  This is important because a great deal of robotics revolves around this concept. Think about autonomous cars. They need to build an internal world replete with virtual pedestrians, vehicles, stop signs, and more, as well as make decisions based on encountering them.
 
