add route description

src/routes/auth/handlers.rs

@@ -36,6 +36,7 @@ pub struct SignInParams {
     password: Option<String>,
 }
 
+/// User Sign In
 #[utoipa::path(
     post,
     request_body = SignInParams,
@@ -96,6 +97,7 @@ pub struct SignUpParams {
     pub password: Option<String>,
 }
 
+/// User Sign Up
 #[utoipa::path(
     post,
     request_body = SignUpParams,
@@ -130,6 +132,7 @@ pub async fn sign_up(
     return Ok(Json(token));
 }
 
+/// Refresh token
 #[utoipa::path(
     post,
     tag = "Auth",
@@ -178,6 +181,7 @@ pub struct CurrentUser {
     pub updated_at: DateTimeWithTimeZone,
 }
 
+/// Current user information
 #[utoipa::path(
     get,
     tag = "Auth",

src/routes/home.rs

@@ -8,6 +8,7 @@ pub struct HomeSchema {
     message: &'static str,
 }
 
+/// Health check
 #[utoipa::path(
     get,
     tag = "Home",

src/swagger/mod.rs

@@ -31,6 +31,9 @@ use utoipa_swagger_ui::SwaggerUi;
             auth::handlers::CurrentUser,
         )
     ),
+    tags(
+        (name = "Auth", description = "Authentication endpoints.")
+    ),
     modifiers(&SecurityAddon)
 )]
 struct ApiDoc;