[pull] main from OAI:main

.gitattributes

@@ -0,0 +1 @@
+*.md linguist-detectable

.github/ISSUE_TEMPLATE/config.yml

@@ -1,17 +1,18 @@
-blank_issues_enabled: true
+blank_issues_enabled: false
+
 contact_links:
-  - name: OpenAPI Specification
-    url: https://spec.openapis.org/oas/latest.html
-    about: View the latest version of the specification
-  - name: Getting started documentation
-    url: https://learn.openapis.org
-    about: Learn about the OpenAPI Specification
-  - name: OpenAPI Tooling
-    url: https://tools.openapis.org
-    about: Open-source and commercial tools for OpenAPI
-  - name: OpenAPI Initiative Registry
-    url: https://spec.openapis.org/registry/index.html
-    about: Registry of formats, extension namespaces etc.
-  - name: OpenAPI Initiative Slack
+  - name: Have a question about using OpenAPI?
     url: https://communityinviter.com/apps/open-api/openapi
-    about: Join our online community.
+    about: Ask us on our Slack!
+  - name: Have a question about OpenAPI Tooling?
+    url: https://tools.openapis.org/
+    about: Please ask your tooling vendor!
+  - name: Want to add to our list of OpenAPI Tools?
+    url: https://tools.openapis.org/
+    about: Please take a look at our tooling site's instructions!
+  - name: Want to suggest more how-to documentation and examples?
+    url: https://github.com/OAI/learn.openapis.org/issues/new
+    about: Please open an issue on our learning site!
+  - name: Want to request a new feature in the specification?
+    url: https://github.com/OAI/OpenAPI-Specification/discussions/new?category=enhancements
+    about: Please start a discussion in this repository!

.github/ISSUE_TEMPLATE/registry_feature_request.md

@@ -0,0 +1,25 @@
+---
+name: Contribute to the registries at spec.openapis.org/registry
+about: Add a new registry entry, or edit an existing one
+title: 'Registry: ...'
+labels: registries
+assignees: ''
+
+---
+
+**Which registry do you want to contribute to**
+- [ ] [Alternative Schema Type Registry](https://spec.openapis.org/registry/alternative-schema)
+- [ ] [Draft Features Registry](https://spec.openapis.org/registry/draft-feature)
+- [ ] [Specification Extension Registry](https://spec.openapis.org/registry/extension)
+- [ ] [Format Registry](https://spec.openapis.org/registry/format)
+- [ ] [Extension Namespace Registry](https://spec.openapis.org/registry/namespace)
+- [ ] [Tag Kind Registry](https://spec.openapis.org/registry/tag-kind)
+
+**Describe your contribution**
+A clear and concise description of what you want to add or change.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**
+Add any other context or screenshots about the feature request here.

.github/ISSUE_TEMPLATE/spec_bug_report.md

@@ -0,0 +1,18 @@
+---
+name: Report an error in the specification
+about: Create a report to help us improve the specification
+title: 'vX.Y: ...'
+labels: ''
+assignees: ''
+
+---
+
+**Describe the error in the specification**
+A clear and concise description of
+- what the error is, 
+- which specification versions are affected, 
+- what you would expect the specification to say instead,  and 
+- a link to the corresponding specification section in the "oldest" affected version.
+
+**Additional context**
+Add any other context about the problem here.

.github/pull_request_template.md

@@ -2,15 +2,20 @@
 Thank you for contributing to the OpenAPI Specification!
 
 Please make certain you are submitting your PR on the correct
-branch and file:
+branch, to the files under the "src/" directory (which is not
+present on the main branch, only on the development branches).
 
-* 3.0.x spec: v3.0.4-dev branch, versions/3.0.4.md
-* 3.1.x spec: v3.1.1-dev branch, versions/3.1.1.md
-* 3.2.0 spec: v3.2.0-dev branch, versions/3.2.0.md
-* 3.0 schema: main branch, schemas/v3.0/...
-* 3.1 schema: main branch, schemas/v3.1/...
+* 3.1.x spec and schemas: v3.1-dev branch
+* 3.2.x spec and schemas: v3.2-dev branch
 * registry templates: gh-pages branch, registry/...
 * registry contents: gh-pages branch, registries/...
+* process documentation and build infrastructure: main
 
 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/templates/agenda.md

@@ -7,7 +7,7 @@ Whether attending or not, **anyone can comment on this issue prior to the meetin
 Meetings take place over Zoom: [https://zoom.us/j/975841675](https://zoom.us/j/975841675?pwd=SUh4MjRLaEFKNlI3RElpWTdhRDVVUT09), dial-in passcode: 763054
 
 ### Accessibility & Etiquette
-* Participants must abide by our [Code-of-Conduct](https://github.com/OAI/OpenAPI-Specification/blob/main/CODE_OF_CONDUCT.md#code-of-conduct).
+* Participants must abide by our [Code-of-Conduct](https://github.com/OAI/OpenAPI-Specification?tab=coc-ov-file).
 
 * Meetings are recorded for future reference, and for those who are not able to attend in-person.
 
@@ -20,7 +20,7 @@ Meetings take place over Zoom: [https://zoom.us/j/975841675](https://zoom.us/j/9
 
 | Blur My Background | Raise Hand |
 |-|-|
-| <img width="323" alt="Screenshot of Zoom UI showing the 'Stop Video' and 'Blur My Background' control" src="https://github.com/OAI/OpenAPI-Specification/assets/7367/7e43dbbb-6529-46e6-8b04-4c1aa852d9dd"> | <img width="323" alt="Screenshot of Zoom UI showing the 'Reaction' and 'Raise Hand' control" src="https://github.com/OAI/OpenAPI-Specification/assets/7367/f991722f-4651-40aa-9bc4-7e9a2a165a6a"> |
+| <img width="323" alt="Screenshot of Zoom UI showing the 'Stop Video' and 'Blur My Background' control" src="https://github.com/OAI/OpenAPI-Specification/assets/7367/7e43dbbb-6529-46e6-8b04-4c1aa852d9dd"> | <img width="323" alt="Screenshot of Zoom UI showing the 'Reaction' and 'Raise Hand' control" src="https://github.com/user-attachments/assets/bf19ee70-59b1-410e-b893-645f26c2c96e"> |
 
 ### Agenda Structure
 
@@ -29,7 +29,8 @@ Meetings take place over Zoom: [https://zoom.us/j/975841675](https://zoom.us/j/9
 Intros and governance meta-topics (5 mins) | TDC | |
 Reports from Special Interest Groups (5 mins) | SIG members | |
 Any other business (add comments below to suggest topics) | TDC | |
-[Approved spec PRs](https://github.com/OAI/OpenAPI-Specification/pulls?q=is%3Apr+is%3Aopen+review%3Aapproved) | TDC | |
+[Approved spec PRs](https://github.com/OAI/OpenAPI-Specification/pulls?q=is%3Apr+is%3Aopen+review%3Aapproved) | @OAI/tsc | |
+[Active Projects](https://github.com/OAI/OpenAPI-Specification/projects?query=is%3Aopen) | @OAI/openapi-maintainers | |
 [New issues needing attention](https://github.com/search?q=repo%3Aoai%2Fopenapi-specification+is%3Aissue+comments%3A0+no%3Alabel+is%3Aopen) | @OAI/triage  | |
 
 /cc [@OAI/tsc](https://github.com/orgs/OAI/teams/tsc) please suggest items for inclusion.

.github/workflows/check-restricted-files.yaml

@@ -0,0 +1,44 @@
+name: check-restricted-files
+
+# Author: @ralfhandl
+# Issue: https://github.com/OAI/OpenAPI-Specification/issues/3432
+
+# This workflow fails if restricted files are changed in a pull request
+
+on:
+  pull_request:
+    paths:
+      - 'schemas/**/*.yaml'
+      - 'versions/*.md'
+
+jobs:
+  check-files:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check changed files
+        shell: bash
+        run: |
+          if [[ "${{ github.event.pull_request.head.repo.full_name }}" == "OAI/OpenAPI-Specification" ]] && \
+             [[ "${{ github.event.pull_request.base.repo.full_name }}" == "OAI/OpenAPI-Specification" ]]; then
+ 
+            if [[ "${{ github.event.pull_request.head.ref }}" == "main" ]] && \
+               [[ "${{ github.event.pull_request.base.ref }}" == "dev" ]]; then
+              echo Sync from main to dev
+              exit 0
+            fi
+
+            if [[ "${{ github.event.pull_request.head.ref }}" == "dev" ]] && \
+               [[ "${{ github.event.pull_request.base.ref }}" =~ ^v[0-9]+\.[0-9]+-dev$ ]]; then
+              echo Sync from dev to ${{ github.event.pull_request.base.ref }}
+              exit 0
+            fi
+
+            if [[ "${{ github.event.pull_request.head.ref }}" =~ ^v[0-9]+\.[0-9]+\.[0-9]+-rel$ ]] && \
+               [[ "${{ github.event.pull_request.base.ref }}" == "main" ]]; then
+              echo Release from ${{ github.event.pull_request.head.ref }} to main
+              exit 0
+            fi
+          fi
+
+          echo This PR contains changes to files that should not be changed
+          exit 1

.github/workflows/respec.yaml

@@ -8,15 +8,13 @@ name: respec
 # on the gh-pages branch when the corresponding markdown files change.
 #
 
-# run this on push to main
+# run this manually from main
 on:
-  push:
-    branches:
-      - main
   workflow_dispatch: {}
 
 jobs:
   respec:
+    if: github.ref == 'refs/heads/main'
 
     runs-on: ubuntu-latest
 
@@ -49,13 +47,13 @@ jobs:
         delete-branch: true
         path: deploy
         labels: Housekeeping
-        reviewers: webron,darrelmiller
-        title: Update ReSpec versions
-        commit-message: Update ReSpec versions
+        reviewers: darrelmiller,webron,earth2marsh,webron,lornajane,mikekistler,miqui,ralfhandl,handrews,karenetheridge
+        title: Update ReSpec-rendered specification versions
+        commit-message: Update ReSpec-rendered specification versions
         signoff: true
         body: |
           This pull request is automatically triggered by GitHub action `respec`.
 
-          The versions/v*.md files have changed, so the HTML files are automatically being regenerated.
+          The `versions/*.md` files have changed, so the HTML files are automatically being regenerated.
 
 

.github/workflows/schema-publish.yaml

@@ -0,0 +1,61 @@
+name: schema-publish
+
+# author: @ralfhandl
+# issue: https://github.com/OAI/OpenAPI-Specification/issues/3715
+
+#
+# This workflow creates a pull request for publishing schema iterations to the gh-pages branch
+#
+
+# run this on push to vX.Y-dev branches or manually
+on:
+  push:
+    branches:
+      - 'v[0-9].[0-9]-dev'
+    paths:
+      - 'src/schemas/validation/*.yaml'
+      - 'scripts/schema-publish.sh'
+      - '.github/workflows/schema-publish.yaml'
+  workflow_dispatch: {}
+
+jobs:
+  publish:
+
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v4 # checkout main branch
+      with:
+        fetch-depth: 0
+
+    - uses: actions/setup-node@v4 # setup Node.js
+      with:
+        node-version: '22.x'
+
+    - name: Install dependencies
+      run: npm ci
+
+    - uses: actions/checkout@v4 # checkout gh-pages branch
+      with:
+        ref: gh-pages
+        path: deploy
+
+    - name: run main script
+      run: scripts/schema-publish.sh
+
+    - name: Create Pull Request
+      uses: peter-evans/create-pull-request@v6
+      with:
+        token: ${{ secrets.GITHUB_TOKEN }}
+        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: '${{ github.ref_name }}: publish OpenAPI schema iterations'
+        commit-message: New OpenAPI schema iterations
+        signoff: true
+        body: |
+          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

@@ -5,7 +5,7 @@ name: schema-test
 
 #
 # This workflow runs the npm test script to validate passing and failing
-# testcases for the metaschema.
+# testcases for the metaschemas
 #
 
 # run this on push to any branch and creation of pull-requests
@@ -23,13 +23,13 @@ jobs:
     - uses: actions/checkout@v4 # checkout repo content
       with:
         fetch-depth: 0
+
     - uses: actions/setup-node@v4 # setup Node.js
       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
-