Skip to content

OpenAPI 3.2: Create sub-issues for 15 adoption opportunities#1715

Merged
pmcelhaney merged 3 commits into
mainfrom
copilot/identify-opportunities-for-counterfact
May 5, 2026
Merged

OpenAPI 3.2: Create sub-issues for 15 adoption opportunities#1715
pmcelhaney merged 3 commits into
mainfrom
copilot/identify-opportunities-for-counterfact

Conversation

Copy link
Copy Markdown
Contributor

Copilot AI commented Apr 8, 2026

Summary

Breaks down OpenAPI 3.2 — Opportunities for Counterfact (#1673) into 15 actionable sub-issue proposals covering server-side, type-generation, and test-only opportunities. Three dashboard-only proposals were excluded since the dashboard has been removed.

Each proposal file in .github/issue-proposals/ includes current state, concrete file-level change targets, and observable acceptance criteria. On merge, CI converts them to real GitHub issues linked as sub-issues of #1673.

Original Prompt

OpenAPI 3.2 was released in early 2025. This issue identifies changes in the specification and maps each one to a concrete opportunity for Counterfact to adopt it so that Counterfact can be listed as an OpenAPI 3.2 early adopter on openapi.tools. Break this issue down into subtasks.

Manual acceptance tests

  • All 15 proposal files are present under .github/issue-proposals/openapi-32-*.md
  • Each proposal has valid YAML front matter with parentIssue: 1673, a non-empty title, and at least one label
  • Each proposal body contains a non-empty description and a checklist of acceptance criteria
  • The CI create-issues workflow processes all 15 files without validation errors on merge
  • All created issues appear as sub-issues of OpenAPI 3.2 — Opportunities for Counterfact #1673 after merge

Tasks

  • Created 15 issue proposal files under .github/issue-proposals/ (3 dashboard-only proposals excluded):
Proposal Feature
openapi-32-query-http-method.md 1a. Native QUERY HTTP method
openapi-32-additional-operations.md 1b. additionalOperations for arbitrary methods
openapi-32-streaming-sse-itemschema.md 2. Streaming / SSE via itemSchema
openapi-32-querystring-parameter.md 3. querystring parameter location
openapi-32-datavalue-serializedvalue-examples.md 4. dataValue/serializedValue examples
openapi-32-optional-discriminator-propertyname.md 5a. Optional discriminator propertyName
openapi-32-discriminator-default-mapping.md 5b. Discriminator defaultMapping
openapi-32-optional-response-description.md 7a. Optional response description
openapi-32-oauth2-device-authorization.md 8a. OAuth2 Device Authorization flow
openapi-32-deprecated-security-scheme.md 8c. @deprecated for deprecated security schemes
openapi-32-self-document-identity.md 9. $self document identity
openapi-32-components-mediatypes.md 10. components/mediaTypes $ref resolution
openapi-32-xml-nodetype.md 11. XML nodeType field
openapi-32-server-name-field.md 12. Server Object name field
openapi-32-json-schema-alignment.md 13. JSON Schema draft-bhutton-01 alignment

Excluded (dashboard removed):

    1. Tag summary/parent/kind — dashboard navigation tree only
  • 7b. Response summary in UI — api-tester.html.hbs has been removed
  • 8b. oauth2MetadataUrl display — dashboard display only

Copilot AI linked an issue Apr 8, 2026 that may be closed by this pull request
Copilot AI changed the title [WIP] Break down OpenAPI 3.2 opportunities for Counterfact OpenAPI 3.2: Create sub-issues for all 18 adoption opportunities Apr 8, 2026
Copilot AI requested a review from pmcelhaney April 8, 2026 02:45
Copy link
Copy Markdown
Collaborator

@pmcelhaney pmcelhaney left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The dashboard has been removed. Remove any issues that would only involve changes to the dashboard.

Copy link
Copy Markdown
Contributor Author

Copilot AI commented May 5, 2026

The dashboard has been removed. Remove any issues that would only involve changes to the dashboard.

Done (35d7cf1). Removed the three dashboard-only proposals:

  • 6. Tag enhancements (summary/parent/kind) — exclusively about the dashboard navigation tree
  • 7b. Response summary UI — exclusively about api-tester.html.hbs (now removed)
  • 8b. oauth2MetadataUrl display — exclusively about displaying a URL in the dashboard

15 proposals remain, all targeting server-side or type-generation changes.

Copilot AI changed the title OpenAPI 3.2: Create sub-issues for all 18 adoption opportunities OpenAPI 3.2: Create sub-issues for 15 adoption opportunities May 5, 2026
Copilot AI requested a review from pmcelhaney May 5, 2026 02:14
@pmcelhaney pmcelhaney marked this pull request as ready for review May 5, 2026 02:15
@pmcelhaney pmcelhaney enabled auto-merge May 5, 2026 02:15
@pmcelhaney pmcelhaney added this pull request to the merge queue May 5, 2026
Merged via the queue into main with commit 4af5653 May 5, 2026
7 of 9 checks passed
@pmcelhaney pmcelhaney deleted the copilot/identify-opportunities-for-counterfact branch May 5, 2026 02:20
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

OpenAPI 3.2 — Opportunities for Counterfact

2 participants