Attachment 148410 Details for Bug 33227 – Bug 33227: (follow-up) Improve docs

[patch] Bug 33227: (follow-up) Improve docs

Bug-33227-follow-up-Improve-docs.patch (text/plain), 2.05 KB, created by Tomás Cohen Arazi (tcohen) on 2023-03-20 11:55:56 UTC

(hide)

Description:

Filename:

MIME Type:

Creator: Tomás Cohen Arazi (tcohen)

Created: 2023-03-20 11:55:56 UTC

Size: 2.05 KB

patch

obsolete

>From b9e3f2abcc91cfc08426cecff00d4cad096be89d Mon Sep 17 00:00:00 2001
>From: Tomas Cohen Arazi <tomascohen@theke.io>
>Date: Mon, 20 Mar 2023 08:48:22 -0300
>Subject: [PATCH] Bug 33227: (follow-up) Improve docs
>
>Signed-off-by: Tomas Cohen Arazi <tomascohen@theke.io>
>---
> api/v1/swagger/paths/biblios.yaml | 24 ++++++++++++++++++++++++
> 1 file changed, 24 insertions(+)
>
>diff --git a/api/v1/swagger/paths/biblios.yaml b/api/v1/swagger/paths/biblios.yaml
>index 5fdf83bc07c..df653702a8f 100644
>--- a/api/v1/swagger/paths/biblios.yaml
>+++ b/api/v1/swagger/paths/biblios.yaml
>@@ -6,6 +6,18 @@
>     tags:
>       - biblios
>     summary: Add biblio
>+    description: |
>+      Add a bibliographic record to Koha. An optional `x-framework-id`
>+      can be passed, to specify the cataloguing framework to be used (instead
>+      of the default).
>+
>+      The request body is expected to contain different record formats depending
>+      on the passed `Content-type` header you specify. Possible values and the required
>+      formats are listed below:
>+
>+      * application/marcxml+xml: MARCXML
>+      * application/marc-in-json: MARC-in-JSON
>+      * application/marc: Raw USMARC binary data
>     parameters:
>       - $ref: "../swagger.yaml#/parameters/framework_id_header"
>       - $ref: "../swagger.yaml#/parameters/marc_schema_header"
>@@ -204,6 +216,18 @@
>     tags:
>       - biblios
>     summary: Update biblio
>+    description: |
>+      Updates a bibliographic record to Koha. An optional `x-framework-id`
>+      can be passed, to specify the cataloguing framework to be used (instead
>+      of the default).
>+
>+      The request body is expected to contain different record formats depending
>+      on the passed `Content-type` header you specify. Possible values and the required
>+      formats are listed below:
>+
>+      * application/marcxml+xml: MARCXML
>+      * application/marc-in-json: MARC-in-JSON
>+      * application/marc: Raw USMARC binary data
>     parameters:
>       - $ref: "../swagger.yaml#/parameters/biblio_id_pp"
>       - $ref: "../swagger.yaml#/parameters/framework_id_header"
>-- 
>2.34.1

Actions: View | Diff | Splinter Review

Attachments on bug 33227: 148213 | 148214 | 148268 | 148269 | 148407 | 148408 | 148410 | 148411 | 168707