Add delete comments endpoint documentation

src/api/public/apidocs-new/OBS-v2.10.50.yaml

@@ -8,6 +8,7 @@ tags:
   - name: Attribute Namespaces
   - name: Attributes
   - name: Build
+  - name: Comments
   - name: Configuration
   - name: Distributions
   - name: General Information
@@ -133,6 +134,9 @@ paths:
   /build/{project_name}/{repository_name}/{architecture_name}/{package_name}/{file_name}?view=fileinfo:
     $ref: 'paths/build_project_name_repository_name_architecture_name_package_name_file_name_view_fileinfo.yaml'
 
+  /comment/{comment_id}:
+    $ref: 'paths/comment_comment_id.yaml'
+
   /configuration:
     $ref: 'paths/configuration.yaml'
 

src/api/public/apidocs-new/paths/comment_comment_id.yaml

@@ -0,0 +1,38 @@
+delete:
+  summary: Delete a comment
+  description: Delete a given comment based on its id.
+  security:
+    - basic_authentication: []
+  parameters:
+    - in: path
+      name: comment_id
+      schema:
+        type: integer
+      required: true
+      description: Id of the comment.
+      example: 1124
+  responses:
+    '200':
+      $ref: '../components/responses/succeeded.yaml'
+    '401':
+      $ref: '../components/responses/unauthorized.yaml'
+    '403':
+      description: 'Forbidden'
+      content:
+        application/xml; charset=utf-8:
+          schema:
+            $ref: '../components/schemas/api_response.yaml'
+          example:
+            code: delete_comment_not_authorized
+            summary: Sorry, you are not authorized to delete this comment
+    '404':
+      description: Not Found
+      content:
+        application/xml; charset=utf-8:
+          schema:
+            $ref: '../components/schemas/api_response.yaml'
+          example:
+            code: not_found
+            summary: Couldn't find Comment with id '1124'
+  tags:
+    - Comments