2 files changed, 25 insertions, 21 deletions

diff --git a/src/routers/account.rs b/src/routers/account.rs
index 71ba496..1ae8c22 100644
--- a/src/routers/account.rs
+++ b/src/routers/account.rs
@@ -34,7 +34,7 @@ struct Token {
 }
 
 #[derive(Deserialize, ToSchema)]
-#[schema(description = "Account register data")]
+#[schema(description = "Body of the account registration request")]
 struct RegisterRequest {
     #[schema(examples("john_doe", "ivanov_ivan"))]
     username: String,
@@ -57,7 +57,7 @@ enum TokenLifetime {
 }
 
 #[derive(Deserialize, ToSchema)]
-#[schema(description = "Account login data")]
+#[schema(description = "Body of the login request")]
 struct LoginRequest {
     #[schema(examples("john_doe", "ivanov_ivan"))]
     username: String,
@@ -69,7 +69,7 @@ struct LoginRequest {
 }
 
 #[derive(Deserialize, ToSchema)]
-#[schema(description = "Change account password data")]
+#[schema(description = "Body of the change account password request")]
 struct ChangePasswordRequest {
     #[schema(examples("secret-password"))]
     old_password: String,
@@ -78,14 +78,14 @@ struct ChangePasswordRequest {
 }
 
 #[derive(Deserialize, ToSchema)]
-#[schema(description = "Change account password data")]
+#[schema(description = "Body of the change account username request")]
 struct ChangeUsernameRequest {
     #[schema(examples("ivanov_ivan", "john_doe"))]
     new_username: String,
 }
 
 #[derive(Deserialize, ToSchema)]
-#[schema(description = "Change account name data")]
+#[schema(description = "Body of the change account name request")]
 struct ChangeNameRequest {
     #[schema(examples("John", "Иван"))]
     first_name: Option<String>,
@@ -94,7 +94,7 @@ struct ChangeNameRequest {
 }
 
 #[derive(Deserialize, ToSchema)]
-#[schema(description = "Account delete data")]
+#[schema(description = "Body of the delete account request")]
 struct DeleteUserRequest {
     #[schema(examples("secret-password"))]
     password: String,
@@ -129,7 +129,7 @@ async fn me(Auth(user): Auth) -> ApiResult<Account> {
     responses(
         (
             status = 200, body = SuccessResponse<Account>,
-            description = "Success response with created account data"
+            description = "Success response with your account data"
         ),
         GlobalResponses
     ),
@@ -213,7 +213,7 @@ async fn login(
     responses(
         (
             status = 200, body = SuccessResponse<Account>,
-            description = "Success response with changed account data"
+            description = "Success response with the updated account data"
         ),
         GlobalResponses
     ),
@@ -246,7 +246,7 @@ async fn change_password(
     responses(
         (
             status = 200, body = SuccessResponse<Account>,
-            description = "Success response with changed account data"
+            description = "Success response with the updated account data"
         ),
         GlobalResponses
     ),
@@ -281,7 +281,7 @@ async fn change_username(
     responses(
         (
             status = 200, body = SuccessResponse<Account>,
-            description = "Success response with changed account data"
+            description = "Success response with the updated account data"
         ),
         GlobalResponses
     ),
@@ -315,7 +315,7 @@ async fn change_name(
     responses(
         (
             status = 200, body = SuccessResponse<Account>,
-            description = "Success response with deleted account data"
+            description = "Success response with the deleted account data"
         ),
         GlobalResponses
     ),
diff --git a/src/routers/queue.rs b/src/routers/queue.rs
index 1e93b2a..df846fb 100644
--- a/src/routers/queue.rs
+++ b/src/routers/queue.rs
@@ -32,12 +32,14 @@ async fn get_owned_queue(
 }
 
 #[derive(Deserialize, ToSchema)]
+#[schema(description = "Body of the create queue request")]
 struct CreateQueueRequest {
     #[schema(examples("John's queue", "Очередь Ивана"))]
     name: String,
 }
 
 #[derive(Deserialize, ToSchema)]
+#[schema(description = "Body of the change queue name request")]
 struct ChangeQueueNameRequest {
     #[schema(examples(1))]
     id: i64,
@@ -46,7 +48,8 @@ struct ChangeQueueNameRequest {
 }
 
 #[derive(Deserialize, ToSchema)]
-struct ChangeQueueOwnerRequest {
+#[schema(description = "Body of the change queue ownership request")]
+struct ChangeQueueOwnershipRequest {
     #[schema(examples(1))]
     id: i64,
     #[schema(examples(1))]
@@ -54,6 +57,7 @@ struct ChangeQueueOwnerRequest {
 }
 
 #[derive(Deserialize, ToSchema)]
+#[schema(description = "Body of the delete queue request")]
 struct DeleteQueueRequest {
     #[schema(examples(1))]
     id: i64,
@@ -64,7 +68,7 @@ struct DeleteQueueRequest {
     path = "/owned",
     tag = QUEUE,
     summary = "Get owned",
-    description = "Get your own queues",
+    description = "Get your queues",
     responses(
         (
             status = 200, body = SuccessResponse<Vec<Queue>>,
@@ -96,7 +100,7 @@ async fn owned(State(state): State<AppState>, Auth(user): Auth) -> ApiResult<Vec
     responses(
         (
             status = 200, body = SuccessResponse<Queue>,
-            description = "Success response with created queue"
+            description = "Success response with the created queue"
         ),
         GlobalResponses
     ),
@@ -129,7 +133,7 @@ async fn create(
     responses(
         (
             status = 200, body = SuccessResponse<Queue>,
-            description = "Success response with changed queue data"
+            description = "Success response with the changed queue data"
         ),
         GlobalResponses
     ),
@@ -155,12 +159,12 @@ async fn change_name(
     path = "/change/owner",
     tag = QUEUE,
     summary = "Change owner",
-    description = "Transfer ownership of the queue",
-    request_body = ChangeQueueOwnerRequest,
+    description = "Reassign queue ownership",
+    request_body = ChangeQueueOwnershipRequest,
     responses(
         (
             status = 200, body = SuccessResponse<Queue>,
-            description = "Success response with changed queue data"
+            description = "Success response with the changed queue data"
         ),
         GlobalResponses
     ),
@@ -169,7 +173,7 @@ async fn change_name(
 async fn change_owner(
     State(state): State<AppState>,
     Auth(user): Auth,
-    ApiJson(req): ApiJson<ChangeQueueOwnerRequest>,
+    ApiJson(req): ApiJson<ChangeQueueOwnershipRequest>,
 ) -> ApiResult<Queue> {
     if !user_exists(req.new_owner_id, &state.db).await? {
         return Err(ClientError::UserNotFound {
@@ -193,12 +197,12 @@ async fn change_owner(
     path = "/delete",
     tag = QUEUE,
     summary = "Delete",
-    description = "Delete queue",
+    description = "Delete the queue",
     request_body = DeleteQueueRequest,
     responses(
         (
             status = 200, body = SuccessResponse<Queue>,
-            description = "Success response with deleted queue data"
+            description = "Success response with the deleted queue data"
         ),
         GlobalResponses
     ),