Document project history endpoint

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

@@ -317,6 +317,8 @@ paths:
     $ref: 'paths/source_project_name_attribute.yaml'
   /source/{project_name}/_attribute/{attribute_name}:
     $ref: 'paths/source_project_name_attribute_attribute_name.yaml'
+  /source/{project_name}/_project/_history:
+    $ref: 'paths/source_project_name_project_history.yaml'
   /source/{project_name}/_project/{file_name}:
     $ref: 'paths/source_project_name_project_file.yaml'
   /source/{project_name}?cmd=addchannels:

src/api/public/apidocs/paths/source_project_name_project_history.yaml

@@ -0,0 +1,87 @@
+get:
+  summary: Get project commit history.
+  description: Get project commit history.
+  security:
+    - basic_authentication: []
+  parameters:
+    - $ref: '../components/parameters/project_name.yaml'
+    - in: query
+      name: deleted
+      schema:
+        type: string
+      description: Set to `1` to allow to retrieve the revision history of a deleted project.
+      example: 1
+    - in: query
+      name: limit
+      schema:
+        type: integer
+      description: Limit the number of retrieved revision history elements to the specified number.
+      example: 20
+    - in: query
+      name: meta
+      schema:
+        type: string
+      description: Set to `1` to retrieve the revision history of the meta file (`_meta`) of the project.
+      example: 1
+    - in: query
+      name: startbefore
+      schema:
+        type: integer
+      description: Start the list of revision history elements before the given revision number.
+      example: 124
+    - in: query
+      name: rev
+      schema:
+        type: string
+      description: Return the revision entry for a specific revision number.
+  responses:
+    '200':
+      description: |
+        OK. The request has succeeded.
+
+        XML Schema used for body validation: [revisionlist.rng](../schema/revisionlist.rng)
+      content:
+        application/xml; charset=utf-8:
+          schema:
+            $ref: '../components/schemas/revision_list.yaml'
+          examples:
+            Two Revisions:
+              value:
+                - rev: 1
+                  vrev: ''
+                  srcmd5: d41d8cd98f00b204e9800998ecf8427e
+                  version: ''
+                  time: 1678364228
+                  user: Admin
+                  comment: project was deleted
+                - rev: 2
+                  vrev: ''
+                  srcmd5: d41d8cd98f00b204e9800998ecf8427e
+                  version: ''
+                  time: 1678364246
+                  user: Admin
+                  comment: project was undeleted
+            rev Parameter Specified (rev = 1):
+              value:
+                - rev: 1
+                  vrev: ''
+                  srcmd5: d41d8cd98f00b204e9800998ecf8427e
+                  version: ''
+                  time: 1678364228
+                  user: Admin
+                  comment: project was deleted
+    '401':
+      $ref: '../components/responses/unauthorized.yaml'
+    '404':
+      description: Not Found.
+      content:
+        application/xml; charset=utf-8:
+          schema:
+            $ref: '../components/schemas/api_response.yaml'
+          examples:
+            Unknown Project:
+              value:
+                code: unknown_project
+                summary: "Project not found: home:some_project"
+  tags:
+    - Sources - Projects