Merge remote-tracking branch 'upstream/dev' into v3.1-dev-merge-dev

Author: ralfhandl

.github/pull_request_template.md

@@ -13,3 +13,9 @@ present on the main branch, only on the development branches).
 
 Note that we do not accept changes to published specifications.
 -->
+
+Tick one of the following options:
+
+- [ ] schema changes are included in this pull request
+- [ ] schema changes are needed for this pull request but not done yet
+- [ ] no schema changes are needed for this pull request

.github/workflows/schema-publish.yaml

@@ -4,14 +4,18 @@ name: schema-publish
 # issue: https://github.com/OAI/OpenAPI-Specification/issues/3715
 
 #
-# This workflow copies the 3.x schemas to the gh-pages branch
+# This workflow creates a pull request for publishing schema iterations to the gh-pages branch
 #
 
-# run this on push to main
+# run this on push to vX.Y-dev branches or manually
 on:
   push:
     branches:
-      - main
+      - 'v?.?-dev'
+    paths:
+      - 'src/schemas/validation/*.yaml'
+      - 'scripts/schema-publish.sh'
+      - '.github/workflows/schema-publish.yaml'
   workflow_dispatch: {}
 
 jobs:
@@ -26,7 +30,7 @@ jobs:
 
     - uses: actions/setup-node@v4 # setup Node.js
       with:
-        node-version: '20.x'
+        node-version: '22.x'
 
     - name: Install dependencies
       run: npm ci
@@ -43,15 +47,15 @@ jobs:
       uses: peter-evans/create-pull-request@v6
       with:
         token: ${{ secrets.GITHUB_TOKEN }}
-        branch: publish-schema-iteration
+        branch: ${{ github.ref_name }}-publish-schema-iteration
         base: gh-pages
         delete-branch: true
         path: deploy
         labels: Housekeeping,Schema
         reviewers: darrelmiller,webron,earth2marsh,webron,lornajane,mikekistler,miqui,ralfhandl,handrews,karenetheridge
-        title: Publish OpenAPI Schema Iterations
+        title: '${{ github.ref_name }}: publish OpenAPI schema iterations'
         commit-message: New OpenAPI schema iterations
         signoff: true
         body: |
-          This pull request is automatically triggered by GitHub action `schema-publish`.
-          The `schemas/**/*.yaml` files have changed and JSON files are automatically generated.
+          This pull request is automatically generated by GitHub action `schema-publish`.
+          The `src/schemas/validation/*.yaml` files have changed and JSON files are automatically generated.

.github/workflows/schema-tests.yaml

@@ -28,10 +28,8 @@ jobs:
       with:
         node-version: '20.x'
 
-    - name: Install dependencies from main
-      run: |
-        git checkout remotes/origin/main -- package.json package-lock.json
-        npm ci
+    - name: Install dependencies
+      run: npm ci
 
     - name: Run tests
       run: npm run test

.github/workflows/validate-markdown.yaml

@@ -18,16 +18,17 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
+  
     - uses: actions/checkout@v4 # checkout repo content
       with:
         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 --yes mdv versions/3.*.md src/oas.md
+
     - name: Lint markdown 3.0.4, 3.1.1, and later
       run: npx --yes markdownlint-cli --config .markdownlint.yaml versions/3.0.4.md versions/3.1.[^0].md versions/3.[2-9].*.md src/oas.md

.gitignore

@@ -6,6 +6,7 @@ target
 atlassian-ide-plugin.xml
 node_modules/
 deploy/
+deploy-preview/
 coverage/
 history
 Gemfile.lock