Document user comments endpoint

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

@@ -136,6 +136,8 @@ paths:
 
   /comment/{comment_id}:
     $ref: 'paths/comment_comment_id.yaml'
+  /comments/user:
+    $ref: 'paths/comments_user.yaml'
   /comments/request/{id}:
     $ref: 'paths/comments_request_id.yaml'
   /comments/project/{project_name}:

src/api/public/apidocs-new/components/schemas/comment.yaml

@@ -12,5 +12,21 @@ properties:
     type: string
     xml:
       attribute: true
+  parent:
+    type: integer
+    xml:
+      attribute: true
+  bsrequest:
+    type: integer
+    xml:
+      attribute: true
+  project:
+    type: string
+    xml:
+      attribute: true
+  package:
+    type: string
+    xml:
+      attribute: true
 # This schema is incomplete due to https://github.com/OAI/OpenAPI-Specification/issues/630,
 # comment element should have content

src/api/public/apidocs-new/components/schemas/comments.yaml

@@ -16,5 +16,9 @@ properties:
     type: string
     xml:
       attribute: true
+  user:
+    type: string
+    xml:
+      attribute: true
 xml:
   name: comments

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

@@ -0,0 +1,22 @@
+get:
+  summary: List all the logged in user's comments
+  description: List all the comments for the currently logged in user.
+  security:
+    - basic_authentication: []
+  responses:
+    '200':
+      description: OK. The request has succeeded.
+      content:
+        application/xml; charset=utf-8:
+          schema:
+            $ref: '../components/schemas/comments.yaml'
+          example: |
+            <comments user="Iggy">
+              <comment who="Iggy" when="2021-10-15 13:28:22 UTC" id="1" bsrequest="115">This is a pretty cool request!</comment>
+              <comment who="Iggy" when="2021-10-15 13:49:39 UTC" id="2" project="home:Admin">This is a pretty cool project!</comment>
+              <comment who="Iggy" when="2021-10-15 13:54:38 UTC" id="3" project="home:Admin" package="0ad">This is a pretty cool package!</comment>
+            </comments>
+    '401':
+      $ref: '../components/responses/unauthorized.yaml'
+  tags:
+    - Comments