v3.0.4(schema): Update empty security array constraint

.github/workflows/validate-markdown.yaml

@@ -18,10 +18,17 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-    - uses: actions/checkout@v1 # checkout repo content
-    - uses: actions/setup-node@v1 # setup Node.js
+    - uses: actions/checkout@v4 # checkout repo content
       with:
-        node-version: '12.x'
+        fetch-depth: 0
+    - name: use the javascript environment from main
+      run: |
+        git checkout remotes/origin/main -- package.json package-lock.json .markdownlint.yaml
+    - uses: actions/setup-node@v4 # setup Node.js
+      with:
+        node-version: '20.x'
     - name: Validate markdown
-      run: npx mdv versions/3.*.md
+      run: npx --yes mdv versions/3.*.md
+    - name: Lint markdown v3.0.4
+      run: npx --yes markdownlint-cli --config .markdownlint.yaml versions/3.0.4.md
 

.gitignore

@@ -5,4 +5,6 @@
 target
 atlassian-ide-plugin.xml
 node_modules/
+deploy/
+history
 Gemfile.lock

.markdownlint.yaml

@@ -0,0 +1,16 @@
+# Unordered list symbol
+MD004:
+    style: asterisk
+
+# Unordered list indentation
+MD007:
+    indent: 2
+
+MD012: false # allow blank lines
+
+MD013:
+    line_length: 800
+    tables: false
+
+MD024: false # duplicate headings
+MD033: false # inline HTML

package.json

@@ -25,5 +25,8 @@
     "Swagger",
     "schema",
     "API"
-  ]
+  ],
+  "scripts": {
+    "format-markdown": "bash ./scripts/format-markdown.sh ./versions/3.0.4.md"
+  }
 }

schemas/v3.0/schema.yaml

@@ -20,6 +20,7 @@ properties:
       $ref: '#/definitions/Server'
   security:
     type: array
+    minItems: 1
     items:
       $ref: '#/definitions/SecurityRequirement'
   tags:
@@ -553,6 +554,7 @@ definitions:
         default: false
       security:
         type: array
+        minItems: 1
         items:
           $ref: '#/definitions/SecurityRequirement'
       servers:

scripts/format-markdown.sh

@@ -0,0 +1,15 @@
+#!/bin/bash
+
+SRCDIR="$(dirname "${BASH_SOURCE[0]}")" # check on Windows
+
+for filename in $*; do
+  # mostly to format code blocks with examples, unfortunately messes up bullet lists and tables
+  npx prettier --write --single-quote $filename
+
+  # repair the tables: remove superfluos spaces and dashes that make diffing revisions harder
+  # and sed -i is not portable, so we need to use a temporary file
+  sed -E -e "s/  +\|/ |/g" -e "s/\|  +/| /g" -e "s/-----+/----/g" $filename > $filename.tmp && mv $filename.tmp $filename
+
+  # repair the bullet lists and various other markdown formatting issues
+  npx --yes markdownlint-cli --fix --config $SRCDIR/../.markdownlint.yaml $filename
+done