Add basic command arguments documentation

src/framework/mod.rs

@@ -73,7 +73,10 @@
 //! 
 //!     async fn execute(&self, ctx: CommandContext<'_, T>, _args: &str) -> Result<(), CommandError> {
 //!         // Your command logic here.
-//!         ctx.send().content("Hello, world!").await.map_err(|_| CommandError::MessageSendingFailed)?;
+//!         ctx.send()
+//!             .content("Hello, world!")
+//!             .await
+//!             .map_err(|_| CommandError::MessageSendingFailed)?;
 //! 
 //!         Ok(())
 //!     }
@@ -88,8 +91,66 @@
 //! bot.run(&token).await.unwrap();
 //! ```
 //! 
-//! Log into your Discord account and invite the bot to your server. Then you can test the command by sending
-//! `p.my_command` in a channel the bot has access to.
+//! Log into your Discord account and invite the bot to your server. Then you can test the command
+//! by sending `p.my_command` in a channel the bot has access to.
+//! 
+//! ### Configuring Commands Further
+//! 
+//! Commands can be configured with additional metadata, such as aliases, descriptions, and
+//! arguments. The following is a full example of a command with all these features:
+//! 
+//! ```
+//! use crate::framework::commands::{Command};
+//! 
+//! pub struct HelloCommand;
+//! 
+//! #[async_trait::async_trait]
+//! impl Command<State> for HelloCommand {
+//!     fn name(&self) -> &'static str {
+//!         "hello"
+//!     }
+//! 
+//!     /// A list of alternative names for the command.
+//!     fn aliases(&self) -> &'static [&'static str] {
+//!        &["hola", "hey", "hi", "konnichiwa"]
+//!     }
+//! 
+//!     /// A description of the command and its functionality.
+//!     fn description(&self) -> &'static str {
+//!         "This command responds with a greeting."
+//!     }
+//! 
+//!     /// A list of arguments the command accepts.
+//!     fn arguments(&self) -> &'static [Argument] {
+//!         &[
+//!             Argument {
+//!                 name: "name",
+//!                 is_optional: false,
+//!                 is_greedy: true,
+//!             },
+//!         ]
+//!     }
+//! 
+//!     async fn execute(
+//!         &self,
+//!         ctx: CommandContext<'_, T>,
+//!         args: &str,
+//!     ) -> Result<(), CommandError> {
+//!         // Parse the arguments using the `ParseArguments` trait.
+//!         let name: NeedyGreedyString = ParseArguments::parse(
+//!             args
+//!         )
+//!         .unwrap_or(NeedyGreedyString("???".to_string()));
+//! 
+//!         ctx.send()
+//!             .content(format!("Hello, {}!", name.0))
+//!             .await
+//!             .map_err(|_| CommandError::MessageSendingFailed)?;
+//! 
+//!         Ok(())
+//!     }
+//! }
+//! ```
 
 pub mod bot;
 pub mod commands;