Add: workflow for linting spec

.github/workflows/lint-openapi.yml

@@ -0,0 +1,30 @@
+name: API linting
+
+# Run on pull requests or pushes when there is a change to the OpenAPI file
+on:
+  push:
+    paths:
+      - docs/
+  pull_request:
+    paths:
+      - docs/
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      # Check out the repository
+      - name: Checkout
+        uses: actions/checkout@v4
+      # Set up node to run the javascript
+      - name: Set up node
+        uses: actions/setup-node@v4
+      # Install Redocly CLI
+      - name: Install Redocly CLI
+        run: npm install -g @redocly/cli@latest
+      # Perform linting for exploded spec
+      - name: Run linting for exploded spec
+        run: redocly lint docs/root.yaml --format=github-actions
+      # Perform linting for bundled spec
+      - name: Run linting for bundled spec
+        run: redocly lint docs/openapi.json --format=github-actions