Update and polish OpenAPI schema

.pre-commit-config.yaml

@@ -66,3 +66,9 @@ repos:
         # Ignore all format-related checks as Black takes care of those.
         args:
           ["--ignore", "E2,W5", "--select", "E,W,F,N", "--max-line-length=120"]
+
+  - repo: https://github.com/adrienverge/yamllint.git
+    rev: v1.26.3
+    hooks:
+    - id: yamllint
+      args: [-c=.yamllint]

.yamllint

@@ -0,0 +1,38 @@
+---
+ignore: |
+  .thothTemplate.yaml
+  .thoth.yaml
+  .pre-commit-config.yaml
+  .prow.yaml
+  .aicoe-ci.yaml
+
+rules:
+  braces: enable
+  brackets: enable
+  colons: enable
+  commas: enable
+  comments:
+    level: warning
+  comments-indentation:
+    level: warning
+  document-end: disable
+  document-start: disable
+  empty-lines: disable
+  empty-values: disable
+  hyphens: enable
+  indentation:
+    level: error
+    spaces: 2
+    indent-sequences: false
+  key-duplicates: enable
+  key-ordering: disable
+  new-line-at-end-of-file: enable
+  new-lines:
+    type: unix
+  octal-values: enable
+  quoted-strings:
+    required: only-when-needed
+    quote-type: double
+  trailing-spaces: enable
+  truthy:
+    level: warning