OAI / OAI/OpenAPI-Specification

v3.0: set up schema maintenance

Open
#4,986 6 comments 0 reactions 1 assignee View on GitHub

@ralfhandl is already working on this.

Since Oct 25, 2025.

Housekeeping Schema
Dominant language
Markdown
Stars
31.2k
Forks
9.2k
Avg merge
6h 37m
Merged PRs (30d)
27

Description

Prepare development branch for v3.0 schema maintenance:

  • create branch v3.0-dev-wip - diff to dev
  • delete src/oas.md - we do not plan a 3.0.5 spec release
    • otherwise: #5094
  • delete src/schemas/validation/*
  • move _archive_/v3.0/schemas/schema.yaml and accompanying README.md to src/schemas/validation/
  • move test-related files from _archive_/v3.0/schemas/ to tests/
  • make tests work and pass
  • refactor tests to use same tools as the v3.1 tests
  • test schema publishing workflow - also works for 3.0
  • adjust selected 3.1 pass/fail test cases to increase schema coverage
  • rename branch v3.0-dev-wip to v3.0-dev (or squash-merge it into a branch freshly created from dev)

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.