Merge remote-tracking branch 'upstream/master' into fix/923-unknown-name-exception

Signed-off-by: Christian Wolf <github@christianwolf.email>

.hooks/pre-commit

@@ -3,7 +3,7 @@
 # set -x
 
 lines_before=`git stash list | wc -l`
-git stash push --keep-index -q
+git stash push --keep-index --include-untracked -q --message "You should never see this commit message. If you do, please repair your git setup manully!"
 lines_after=`git stash list | wc -l`
 
 cleanup() {

CHANGELOG.md

@@ -9,6 +9,8 @@
   [#956](https://github.com/nextcloud/cookbook/pull/956) @christianlupus
 - Correct handling of empty recipe name in the backend
   [#973](https://github.com/nextcloud/cookbook/pull/973) @christianlupus
+- Fix problem with git pre-commit hook dropping files unintentionally
+  [#974](https://github.com/nextcloud/cookbook/pull/974) @christianlupus
 
 ### Documentation
 - Corrected some spelling issues
@@ -19,6 +21,8 @@
   [#936](https://github.com/nextcloud/cookbook/pull/947) @zorglubu
 - Updated French translation
   [#957](https://github.com/nextcloud/cookbook/pull/957) @zorglubu
+- Add example to OpenAPI specification
+  [#957](https://github.com/nextcloud/cookbook/pull/972) @christianlupus
 
 
 ## 0.9.11 - 2022-03-28

docs/dev/api/0.0.2/openapi-cookbook.yaml

@@ -392,7 +392,29 @@ paths:
     post:
       tags: [ Recipes ]
       summary: Create a new recipe
-      #requestBody:
+      requestBody:
+        description: |
+          A JSON representation of the recipe to be saved.
+          
+          See also the structure at https://schema.org/Recipe
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                name:
+                  type: string
+              required: [ "name" ]
+              additionalProperties: true
+              example:
+                name: "Chips"
+                description: "A very delicious way of getting kids quiet"
+                ingredients:
+                  - "1 pack of pre-fried chips"
+                tools: ["common oven"]
+                instructions:
+                  - "Put the chips in the oven"
+                  - "Wait until the are due"
       responses:
         200:
           description: Successfully created new recipe