diff --git a/v2/swagger.yaml b/v2/swagger.yaml
index 9bb3559..87ef88f 100644
--- a/v2/swagger.yaml
+++ b/v2/swagger.yaml
@@ -1985,7 +1985,7 @@ paths:
     get:
       tags:
         - comment
-      summary: Comment view in the "Published" status (STATUS_APPROVED). Access allowed with "See comments" (show-content-comments) role permission.
+      summary: View comment data. Returns comments data only in the "Published" status (STATUS_APPROVED). Access allowed with "See comments" (show-content-comments) role permission.
       operationId: /comment/view
       parameters:
         - name: id
@@ -2080,7 +2080,7 @@ paths:
     delete:
       tags:
         - comment
-      summary: Comment safe delete (changes it's status to STATUS_DELETED). Access is allowed to the comment creator or users with the "Moderate comments" role permission (content-moderate-comments).
+      summary: Comment safe delete (changes comment status to STATUS DELETED). Access is allowed for comment author or users with "Moderate comments" role permission (content-moderate-comments).
       operationId: /comment/delete
       parameters:
         - name: id