Document person show endpoint

The OpenAPI documentation for the `person#show` action.

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

@@ -6,6 +6,7 @@ servers:
 tags:
   - name: General Information
   - name: Groups
+  - name: Person
 
 info:
   description: Open Build Service API
@@ -34,6 +35,9 @@ paths:
   /group/{group_title}:
     $ref: 'paths/group_group_title.yaml'
 
+  /person:
+    $ref: 'paths/person.yaml'
+
 components:
   securitySchemes:
     basic_authentication:

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

@@ -0,0 +1,40 @@
+get:
+  summary: List all people.
+  description: >
+    List all people.
+  security:
+    - basic_authentication: []
+  parameters:
+    - in: query
+      name: prefix
+      schema:
+        type: string
+      required: false
+      description: A prefix to filter the people to look for
+      example: 'Adm'
+  responses:
+    '200':
+      description: >
+        OK. The request has succeeded.
+
+        XML Schema used for body validation: [directory.xsd](../schema/directory.xsd)
+      content:
+        application/xml; charset=utf-8:
+          schema:
+            $ref: '../components/schemas/directory.yaml'
+          example:
+            count: '9'
+            entry:
+              - name: 'Admin'
+              - name: '_nobody_'
+              - name: 'Iggy'
+              - name: 'user_1'
+              - name: 'repo-checker'
+              - name: 'reviewhero'
+              - name: 'user_2'
+              - name: 'user_3'
+              - name: 'Requestor'
+    '401':
+      $ref: '../components/responses/unauthorized.yaml'
+  tags:
+    - Person

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

@@ -0,0 +1,18 @@
+post:
+  summary: Registers a new person
+  security:
+    - basic_authentication: []
+  requestBody:
+    description: Data for the person to register.
+    required: true
+    content:
+      application/xml:
+        schema:
+          $ref: '../components/schemas/unregisteredperson.yaml'
+  responses:
+    '200':
+      $ref: '../components/responses/succeeded.yaml'
+    '401':
+      $ref: '../components/responses/unauthorized.yaml'
+  tags:
+    - Person