docs: Improve schemas docs

Fixes: #32
Signed-off-by: Awiteb <a@4rs.nl>

crates/oxidetalis/src/schemas/mod.rs

@@ -33,15 +33,7 @@ mod user;
 
 pub use user::*;
 
-/// Json message schema, used for returning messages to the client, the message
-/// must be human readable.
-///
-/// # Example
-/// ```json
-/// {
-///    "message": "Message"
-/// }
-/// ```
+/// Message schema, used for returning messages.
 #[derive(Serialize, Deserialize, Clone, Debug, ToSchema, derive_new::new)]
 #[salvo(schema(name = MessageSchema, example = json!(MessageSchema::new("Message".to_owned()))))]
 pub struct MessageSchema {

crates/oxidetalis/src/schemas/user.rs

@@ -24,6 +24,7 @@ use oxidetalis_entities::prelude::*;
 use salvo::oapi::ToSchema;
 use serde::{Deserialize, Serialize};
 
+/// WhiteListed user schema, represents a whitelisted user.
 #[derive(Serialize, Deserialize, Clone, Debug, ToSchema, derive_new::new)]
 #[salvo(schema(name = WhiteListedUser, example = json!(WhiteListedUser::default())))]
 pub struct WhiteListedUser {
@@ -33,6 +34,7 @@ pub struct WhiteListedUser {
     pub whitelisted_at: DateTime<Utc>,
 }
 
+/// Blacklisted user schema, represents a blacklisted user.
 #[derive(Serialize, Deserialize, Clone, Debug, ToSchema, derive_new::new)]
 #[salvo(schema(name = BlackListedUser, example = json!(BlackListedUser::default())))]
 pub struct BlackListedUser {