docs: add more module level documentation + other minor stuff

pros-sys/src/misc.rs

@@ -6,9 +6,14 @@ pub const COMPETITION_AUTONOMOUS: u8 = 1 << 0;
 pub const COMPETITION_DISABLED: u8 = 1 << 1;
 pub const COMPETITION_CONNECTED: u8 = 1 << 2;
 extern "C" {
+    /// Get the current status of the competition control.
+    /// Returns The competition control status as a mask of bits with COMPETITION_{ENABLED,AUTONOMOUS,CONNECTED}.
     pub fn competition_get_status() -> u8;
+    /// Returns true if the robot is in autonomous mode, false otherwise.
     pub fn competition_is_autonomous() -> bool;
+    /// Returns true if the V5 Brain is connected to competition control, false otherwise.
     pub fn competition_is_connected() -> bool;
+    /// Returns true if the V5 Brain is disabled, false otherwise.
     pub fn competition_is_disabled() -> bool;
 }
 // controller

pros/src/battery.rs

@@ -1,3 +1,5 @@
+//! Utilites for getting information about the robot's battery.
+
 /// Get the robot's battery capacity.
 pub fn get_capacity() -> f64 {
     unsafe { pros_sys::misc::battery_get_capacity() }

pros/src/competition.rs

@@ -1,3 +1,5 @@
+//! Utilities for getting what state of the competition the robot is in.
+
 /// The current status of the robot, allowing checks to be made
 /// for autonomous, disabled, and connected states.
 #[derive(Debug, Clone, Copy, PartialEq, Eq)]

pros/src/controller.rs

@@ -1,3 +1,5 @@
+//! Read from the buttons and joysticks on the controller and write to the controller's display.
+
 use alloc::{ffi::CString, vec::Vec};
 use pros_sys::{controller_id_e_t, PROS_ERR};
 use snafu::Snafu;
@@ -40,6 +42,7 @@ pub struct ControllerState {
     pub buttons: Buttons,
 }
 
+/// Represents one line on the controller console.
 pub struct ControllerLine {
     controller: Controller,
     line: u8,

pros/src/task/mod.rs

@@ -1,6 +1,5 @@
 //! Functions for creation and management of tasks.
-//! Tasks are the main way to run code asynchronously.
-//! 
+//!
 //! Tasks can be created with the [`spawn`] function or, for more control, with a task [`Builder`].
 //! ## Example
 //! ```rust
@@ -9,7 +8,7 @@
 //! });
 //! ```
 //! After a task has been spawned you can manage it with the returned [`TaskHandle`].
-//! 
+//!
 //! Task locals can be created with the [`os_task_local!`](crate::os_task_local!) macro.
 //! See the [`local`] module for more info.