Add documentation for main.rs

src/main.rs

@@ -139,6 +139,10 @@ mod logging;
 mod state;
 mod utils;
 
+/// Payphone's main entrypoint function.
+/// 
+/// Parses ENV variables and CLI arguments, sets up the logger, and runs [`start`] or [`docs`]
+/// depending on the command.
 #[tokio::main]
 pub async fn main() {
     dotenvy::dotenv().ok();
@@ -162,6 +166,9 @@ pub async fn main() {
     }
 }
 
+/// Starts a Payphone shard.
+/// 
+/// TODO: Support multiple shards.
 async fn start(token: String, database_addr: String) {
     log::info!("Welcome to Payphone, Nyeki!");
     log::info!(
@@ -195,6 +202,10 @@ async fn start(token: String, database_addr: String) {
     bot.run(&token).await.expect("Could not run bot!");
 }
 
+/// Boots up a documentation server.
+/// 
+/// It compiles the crate's documentation and recompiles it automatically when the source code
+/// changes.
 async fn docs(bind: SocketAddr, open_on_start: bool) {
     log::info!("Compiling documentation...");