Skip to content

Official 3.2.0 release branch #4970

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 511 commits into from
Sep 19, 2025
+5,626 −6,116
Merged

Official 3.2.0 release branch #4970

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
511 commits
Select commit Hold shift + click to select a range
6572370
Merge pull request #4663 from baywet/fix/missing-ref-schema-media-and…
handrews Jun 13, 2025
f9b0017
Use matching jsonSchemaDialect
handrews Jun 12, 2025
98ae842
Add XML Object schema tests
handrews Jun 13, 2025
0a223cd
Use externalDocs in a schema test object
handrews Jun 13, 2025
27516b6
Cover discriminator with schema test cases
handrews Jun 13, 2025
94f4b26
Merge pull request #4704 from handrews/test-32
handrews Jun 13, 2025
50abcbf
Use full schema (schema-base) for tests
handrews Jun 13, 2025
3ee2f01
Merge pull request #4710 from handrews/test-cov-32
ralfhandl Jun 13, 2025
23e9712
Root XML element name comes from component name
handrews May 13, 2025
00fe2ed
Align wording with components rather than "root"
handrews May 15, 2025
6850e16
Support all common XML node types
handrews May 14, 2025
63ba3e3
Better wording and formatting
handrews May 16, 2025
e2e2d7b
A bit more formatting improvements
handrews May 16, 2025
d775e9b
Fix missing word
handrews May 16, 2025
9577389
Make the DOM reference normative
handrews May 16, 2025
564b2ce
Improved wording around nodeType: none
handrews May 16, 2025
9709537
Expand examples, link from field description.
handrews May 19, 2025
792efcc
Provide guidance on null in XML.
handrews May 18, 2025
e330609
Add `null` guidance for CDATA and text
handrews May 28, 2025
92b3f4b
Fix example to name the item nodes correctly
handrews May 28, 2025
a4f6bd9
Apply suggestions from code review
handrews Jun 12, 2025
373a374
Update src/oas.md
handrews Jun 12, 2025
c7f0c47
Add positive schema tests for XML nodeType
handrews Jun 13, 2025
12df956
Add negative nodeType schema tests
handrews Jun 13, 2025
24344f3
Merge pull request #4592 from handrews/nodetype
handrews Jun 13, 2025
93c6687
XML Object example updates
handrews Jun 9, 2025
bbea8ff
Merge pull request #4657 from handrews/generics
miqui Jun 14, 2025
67b34d4
Fix copy-paste error
handrews Jun 14, 2025
fb1ae5c
Use matching jsonSchemaDialect
handrews Jun 12, 2025
574c177
Update json_schema_dialect.yaml
ralfhandl Jun 14, 2025
58c7445
Merge pull request #4725 from ralfhandl/3.2-fix-automation
handrews Jun 14, 2025
855824c
Clarify that Request Body Objects need a body
handrews May 18, 2025
bdfbbcf
Merge remote-tracking branch 'upstream/dev' into 3.2-merge-dev
ralfhandl Jun 15, 2025
8604a79
Merge pull request #4727 from ralfhandl/3.2-merge-dev
handrews Jun 15, 2025
4972cc0
Merge pull request #4726 from handrews/req-content-320
handrews Jun 15, 2025
2c100c2
Merge pull request #4733 from OAI/dev
handrews Jun 16, 2025
a263d3c
improve wording for servers object and url
karenetheridge Apr 3, 2025
22fbdc9
Merge pull request #4739 from OAI/dev
ralfhandl Jun 18, 2025
3d17b0d
Add support for application/linkset[+json]
handrews Jun 12, 2025
b300214
Provide guidance for multiple contentType values
handrews Jun 21, 2025
aa33fda
Support nested Encoding Objects
handrews Jun 9, 2025
229e57a
Merge pull request #4734 from karenetheridge/ether/server-url-default
handrews Jul 2, 2025
18c753a
Merge pull request #4755 from OAI/dev
handrews Jul 3, 2025
97d8c94
Clarify JSON-compatible YAML and UTF-8 use
handrews Jul 4, 2025
454ba92
Simplify the JSON/YAML stuff
handrews Jul 5, 2025
55ebffb
Fix comma usage
handrews Jul 8, 2025
6cba994
Merge pull request #4774 from OAI/dev
oai-spec-publisher[bot] Jul 10, 2025
32f028c
Drop the idea of example overriding
handrews Jul 12, 2025
12a8939
Merge pull request #4776 from handrews/no-override
ralfhandl Jul 13, 2025
b19e612
Merge pull request #4740 from handrews/linkset
lornajane Jul 16, 2025
866dd89
Use current form for normative ref
handrews Jul 17, 2025
ef3e51e
Move URI/URL resolution under OAD Structure
handrews Jul 17, 2025
99e5ce0
Clarify template variable uniqueness
handrews Jul 17, 2025
5cfb332
Fix missing space
handrews Jul 17, 2025
62d67f3
Provide parsing and serialization guidance
handrews Jul 17, 2025
45b0faf
Merge pull request #4792 from handrews/missing-space
ralfhandl Jul 18, 2025
88aa65b
Merge pull request #4744 from handrews/multi-media
ralfhandl Jul 18, 2025
2c7432c
Merge pull request #4791 from handrews/single-var
ralfhandl Jul 18, 2025
9fb9893
Apply suggestions from code review
handrews Jul 18, 2025
5661d71
Expand type guidance and optional further inspection
handrews Jul 18, 2025
2dc01c9
Editorial improvements to Appendix E
handrews Jul 18, 2025
5f9ce8e
Fix example thanks to review feedback
handrews Jul 18, 2025
6869ddd
Add data vs serialized example fields
handrews Jun 6, 2025
d2a6d08
Explain Param and Header example serialization
handrews Jul 11, 2025
62751e7
Parameter and Header example updates
handrews Jul 11, 2025
6faaed3
No new external fields.
handrews Jul 18, 2025
042e708
Allow Parameter/Header examples w/content
handrews Jul 12, 2025
a0502e7
No new external fields for the Example Object
handrews Jul 18, 2025
7c98128
Provide guidance for Set-Cookie
handrews Jun 23, 2025
d2d0bad
Fix typo
handrews Jun 30, 2025
1323840
Explain when Set-Cookie workaround is needed
handrews Jul 4, 2025
8d618d1
Better wording and grammar
handrews Jul 8, 2025
5a76ba6
Revamp with more examples and less explanation
handrews Jul 4, 2025
f4927bf
Apply suggestions from code review
handrews Jul 19, 2025
5e028a6
Merge pull request #4672 from handrews/ex-obj-ex
ralfhandl Jul 19, 2025
741a0e7
Merge pull request #4790 from handrews/consolidate
lornajane Jul 19, 2025
52b3218
Merge pull request #4797 from handrews/pctenc
lornajane Jul 19, 2025
00dbb5d
Merge pull request #4758 from handrews/yaml
lornajane Jul 19, 2025
a7c9c0c
Review feedback and maintainability
handrews Jul 19, 2025
dfbda97
Remove redundant $ref
handrews Jul 19, 2025
5620635
Fix ETag example.
handrews Jul 19, 2025
30b2c04
Fix missing word
handrews Jul 19, 2025
5d5ea9f
Review feedback.
handrews Jul 19, 2025
678cec6
Further serialization and Unicode guidance.
handrews Jul 19, 2025
747ccc8
Allow Media Type Object re-use
handrews Jul 19, 2025
f88dc0d
Fix typo
handrews Jul 19, 2025
ec1e510
Fix inadvertent plural
handrews Jul 19, 2025
767bdaf
Remove documentation requirement
handrews Jul 19, 2025
459e5bb
Schema updates for #4339
mikekistler Jul 20, 2025
45d844c
Merge pull request #4728 from handrews/mt-e-components
ralfhandl Jul 20, 2025
22e5582
Merge pull request #4747 from handrews/nested-multi
ralfhandl Jul 20, 2025
af2a5a8
Fix grammar
handrews Jul 20, 2025
62d56f0
Support ordered multipart including streaming
handrews Jun 21, 2025
dce24e4
Be more clear about correlations.
handrews Jul 9, 2025
e8b58f5
Review feedback
handrews Jul 17, 2025
ca415e4
More maintainable wording
handrews Jul 17, 2025
0b37bca
New encoding examples
handrews Jun 21, 2025
67e81b9
Better RFC2557 example
handrews Jun 21, 2025
7e8f352
Review feedback.
handrews Jul 17, 2025
674059b
Less snark in the comments
handrews Jul 18, 2025
3a78835
Apply suggestions from PR review
mikekistler Jul 20, 2025
25fe305
Merge pull request #4805 from OAI/mdk/4804-optional-discriminator-schema
handrews Jul 22, 2025
a514ba3
Fix missing component names
handrews Jul 23, 2025
f39ddfd
Fix paragraph order on multipart encoding
handrews Jul 23, 2025
08ee9d6
Merge pull request #4812 from handrews/enc-editorial
handrews Jul 24, 2025
3f57f49
Fix spelling
handrews Jul 24, 2025
cb8baa3
Fix examples (review feedback)
handrews Jul 24, 2025
2940af6
Merge pull request #4799 from handrews/ex-obj-3
lornajane Jul 24, 2025
fb8af87
Merge pull request #4800 from handrews/style-examples-3
handrews Jul 24, 2025
c097759
Merge pull request #4745 from handrews/mixed2
handrews Jul 24, 2025
2600500
maintainable
handrews Jul 24, 2025
2359b8d
More correct from review feedback
handrews Jul 24, 2025
79ec626
Merge pull request #4793 from handrews/schema-inspect
handrews Jul 24, 2025
545cff1
Merge pull request #4802 from handrews/content-examples-3
handrews Jul 24, 2025
774f70c
Merge pull request #4748 from handrews/set-cookie
lornajane Jul 24, 2025
75ac257
Merge pull request #4801 from handrews/param-header-ex-3
miqui Jul 26, 2025
60c4de3
Merge pull request #4711 from handrews/xml-ex
handrews Jul 26, 2025
2b179ff
Fix accidentally removed type
handrews Jul 30, 2025
805084d
Merge pull request #4746 from handrews/mixed-examples
lornajane Jul 31, 2025
f4101ad
Fix deepObject explode default behavior.
handrews Aug 2, 2025
533c6d3
Consolidate example line
handrews Aug 7, 2025
0c17528
Reusable request bodies need a name
ralfhandl Aug 12, 2025
1018632
Merge pull request #4840 from ralfhandl/3.2-fix-broken-fail-testcases
ralfhandl Aug 12, 2025
00d5e85
Merge pull request #4846 from OAI/dev
ralfhandl Aug 12, 2025
657ba5d
Merge pull request #4849 from OAI/dev
oai-spec-publisher[bot] Aug 12, 2025
87f87f6
Merge pull request #4852 from OAI/dev
oai-spec-publisher[bot] Aug 12, 2025
fb16c2b
Correct test suite name
ralfhandl Aug 12, 2025
dd3f299
full keyword and line coverage
ralfhandl Aug 12, 2025
8cafb94
Merge pull request #4861 from OAI/dev
oai-spec-publisher[bot] Aug 13, 2025
a068e0b
Merge pull request #4853 from ralfhandl/3.2-test-suite-name
ralfhandl Aug 13, 2025
9c87c41
Merge remote-tracking branch 'upstream/v3.2-dev' into 3.2-schema-test…
ralfhandl Aug 13, 2025
8ef1e65
Merge pull request #4856 from ralfhandl/3.2-schema-test-keyword-coverage
ralfhandl Aug 13, 2025
adc6cb4
Merge pull request #4818 from handrews/deepo
handrews Aug 13, 2025
d50527b
New percent-encoding section under Parameter Object
handrews Aug 2, 2025
1264d08
Fix guidance for RFC6570 and multipart/form-data
handrews Aug 2, 2025
0fd14b6
Fix guidance on headers and RFC6570 percent-encoding
handrews Aug 2, 2025
56faefa
Fix list formatting (use periods at end)
handrews Jul 11, 2025
f100052
Update examples and appendicies for percent-encoding
handrews Aug 3, 2025
e295dcf
Remove duplicate field in YAML example
handrews Aug 13, 2025
1aedca9
Merge pull request #4864 from handrews/dup-examples
handrews Aug 14, 2025
7338e16
Fix missed update to example from ported changes
handrews Aug 14, 2025
2a86e81
Merge pull request #4863 from handrews/port-pct
lornajane Aug 14, 2025
796eb84
Merge pull request #4874 from OAI/dev
oai-spec-publisher[bot] Aug 15, 2025
912a96e
Convention is to use lowercase
ralfhandl Aug 17, 2025
2dadb57
Typos and editorial changes
ralfhandl Aug 16, 2025
26c934e
Merge pull request #4882 from ralfhandl/3.2-code-block-language-lower…
handrews Aug 17, 2025
cb30750
Merge pull request #4886 from OAI/dev
oai-spec-publisher[bot] Aug 18, 2025
bc35e9c
Merge pull request #4891 from OAI/dev
oai-spec-publisher[bot] Aug 20, 2025
bf0d54a
Merge pull request #4876 from ralfhandl/3.2-typos
ralfhandl Aug 20, 2025
0193c67
Merge pull request #4898 from OAI/dev
oai-spec-publisher[bot] Aug 21, 2025
d44b34f
Encoding style default behavior
handrews Aug 18, 2025
0e8e7e3
Update Set-Cookie example for recent changes
handrews Aug 21, 2025
0a73308
Fix allowReserved
handrews Aug 21, 2025
49d1c51
Merge pull request #4900 from handrews/allow-reserved
ralfhandl Aug 21, 2025
b78f66a
Add style: cookie, explain pct-encoding
handrews Aug 21, 2025
a83ae2a
Merge pull request #4899 from handrews/enc-style-defaults
lornajane Aug 21, 2025
ddf91fb
checkpoint
handrews Aug 21, 2025
f02e752
whatwg
handrews Aug 21, 2025
d62df60
Apply suggestions from code review
handrews Aug 21, 2025
125c34c
Apply suggestions from code review
handrews Aug 21, 2025
ee1021a
Fix review suggestion that broke build.
handrews Aug 21, 2025
9e03421
Review feedback.
handrews Aug 21, 2025
585321d
Fix error in example.
handrews Aug 21, 2025
34cd332
grammar fix
handrews Aug 22, 2025
f0b3fa8
grammar
handrews Aug 22, 2025
e4c0230
Merge pull request #4902 from handrews/cookie32-noschema
lornajane Aug 23, 2025
d17c44d
Merge pull request #4903 from handrews/set-cookie-example
ralfhandl Aug 25, 2025
b3b4233
Merge pull request #4905 from handrews/urlencoded
handrews Aug 26, 2025
fc77a73
Reorganize early (and other) sections
handrews Aug 25, 2025
fb45114
Fix heading levels post-section reorganization.
handrews Aug 25, 2025
1328ee8
Parameter Object with in:querystring can't have content
ralfhandl Aug 28, 2025
3f1df3f
OAD schema 'parameter object' + in: querystring drop `not`+`required`…
notEthan Aug 28, 2025
904873e
Merge pull request #4909 from notEthan/oad-schema-querystring-forbid-…
handrews Aug 29, 2025
690560b
Merge pull request #4908 from handrews/sections
handrews Aug 31, 2025
14e5667
Merge Versions and Deprecation sections
handrews Aug 22, 2025
2c56b00
Remove outdated Server Object crossref
handrews Aug 22, 2025
445d76f
Rename "Schema" to "Objects and Fields"
handrews Aug 22, 2025
f80a4cd
Add links to Introduction.
handrews Aug 27, 2025
2b4c061
Remove counter-intuitive section name hack.
handrews Aug 28, 2025
5a17b01
Improve Link Object Examples
handrews Aug 14, 2025
cc1d673
Port review feedback from v3.1-dev
handrews Aug 27, 2025
61177cb
Fix outdated RFC ref ported from 3.1
handrews Aug 28, 2025
de84701
Fix the moved Media Types section
handrews Aug 31, 2025
8b999d1
Merge pull request #4916 from handrews/mts
handrews Sep 1, 2025
c37475c
Merge pull request #4915 from handrews/from-31
ralfhandl Sep 2, 2025
c3f5b96
Merge pull request #4913 from handrews/misc-reorg
lornajane Sep 3, 2025
130f076
Merge pull request #4922 from OAI/dev
oai-spec-publisher[bot] Sep 4, 2025
dc5dad6
"example" and "examples" cannot appear together
karenetheridge Aug 31, 2025
2933fe9
Merge pull request #4912 from karenetheridge/ether/v3.2-example-examp…
ralfhandl Sep 5, 2025
e857e6e
Refactor OpenAPI Description Structure sections
handrews Aug 28, 2025
9e49f96
Streamline OpenAPI Description Structure post-moves
handrews Aug 28, 2025
4c6fcd2
Fix spelling
handrews Sep 8, 2025
33c6719
Fix openapi field's description of version field
handrews Sep 8, 2025
b1eedf2
Wording feedback
handrews Sep 8, 2025
3da8f96
Merge pull request #4934 from OAI/dev
oai-spec-publisher[bot] Sep 8, 2025
28922ae
Merge pull request #4936 from OAI/dev
oai-spec-publisher[bot] Sep 8, 2025
1e94ea4
Merge pull request #4927 from handrews/oad2
lornajane Sep 9, 2025
7926ee2
fix broken link
ralfhandl Sep 12, 2025
319871b
Consistent dashing for case sensitive
ralfhandl Sep 12, 2025
07f11cb
Typo
ralfhandl Sep 12, 2025
c1076ff
Consistent dashes in URI reference
ralfhandl Sep 12, 2025
31eef03
Consistent use of "JSON Pointer"
ralfhandl Sep 12, 2025
27432d7
Remove unnecessary sentence
ralfhandl Sep 12, 2025
af2c85d
Consistent formatting
ralfhandl Sep 12, 2025
46366ec
Add informative reference to JSONPath
ralfhandl Sep 12, 2025
628f1e8
Informative reference to HTML Standard
ralfhandl Sep 12, 2025
7cc727a
Misspelled anchor
ralfhandl Sep 12, 2025
7244caa
Use current section header as link text
ralfhandl Sep 12, 2025
5d5d9a5
Remove irritating comma
ralfhandl Sep 12, 2025
942cf8c
base uri: reference RFC3986
ralfhandl Sep 12, 2025
a70261b
Merge pull request #4943 from ralfhandl/3.2-4.1.2.2-typo
ralfhandl Sep 12, 2025
4fd4f34
Merge pull request #4945 from ralfhandl/3.2-uri-reference
ralfhandl Sep 12, 2025
90d6f99
Merge pull request #4949 from ralfhandl/3.2-jsonpath-reference
lornajane Sep 14, 2025
9a8cdb6
Merge pull request #4950 from ralfhandl/3.2-reference-html5
lornajane Sep 14, 2025
69c0b31
Merge pull request #4951 from ralfhandl/3.2-encoding-usage-broken-link
lornajane Sep 14, 2025
3781a47
Merge pull request #4952 from ralfhandl/3.2-sse-streams-section-refer…
lornajane Sep 14, 2025
b06ccfc
Merge pull request #4953 from ralfhandl/3.2-example-object-irritating…
lornajane Sep 14, 2025
d3abb59
Merge pull request #4954 from ralfhandl/3.2-rfc3886-references
lornajane Sep 14, 2025
916e5c6
Merge pull request #4948 from ralfhandl/3.2-style-examples-formatting
lornajane Sep 14, 2025
d9a291c
Merge pull request #4947 from ralfhandl/3.2-serialization-remove-unne…
lornajane Sep 14, 2025
cd64743
Merge pull request #4946 from ralfhandl/3.2-json-pointer
lornajane Sep 14, 2025
38c789f
Merge pull request #4941 from ralfhandl/3.2-broken-implicit-connectio…
lornajane Sep 14, 2025
57c9da5
Switch to dashed variant everywhere
ralfhandl Sep 15, 2025
4e1877b
pull out subschemas that do not need to be in an allOf
karenetheridge Aug 31, 2025
2773541
remove redundant $ref: examples are allowed in "content" now too
karenetheridge Sep 5, 2025
3c675a8
use non-capturing parentheses everywhere
karenetheridge Sep 6, 2025
9ac8910
remove redundant "requires"
karenetheridge Sep 12, 2025
b5c43e5
case sensitivity (noun) without dashes
ralfhandl Sep 15, 2025
c4673bc
whitespace
karenetheridge Sep 12, 2025
c602ca6
remove confusing use of json within yaml
karenetheridge Sep 12, 2025
33907e0
clarify other prohibited combinations of query+querystring
karenetheridge Sep 15, 2025
a3082cb
be explicit that this table shows ALL valid combinations
karenetheridge Sep 15, 2025
8290d55
Markdown improvements for the Style Values table
karenetheridge Sep 15, 2025
9adf475
remove json markup in yaml examples of literal values
karenetheridge Sep 15, 2025
14528c9
query and querystring are mutually exclusive; disallow more than one …
karenetheridge Aug 31, 2025
21010ce
allow the use of in: cookie, style: cookie
karenetheridge Sep 12, 2025
2463bd0
style and allowReserved defaults are only in effect when any of style…
karenetheridge Sep 13, 2025
bea55aa
Merge pull request #4942 from ralfhandl/3.2-case-sensitive
ralfhandl Sep 16, 2025
153c4ca
Merge pull request #4964 from OAI/dev
oai-spec-publisher[bot] Sep 16, 2025
259ea07
Merge branch 'v3.2-dev' into ether/v3.2-spec-markup
ralfhandl Sep 16, 2025
5f38d1d
Merge pull request #4959 from karenetheridge/ether/v3.2-spec-markup
ralfhandl Sep 16, 2025
466b723
fix character terminology in ABNF comments
karenetheridge Sep 16, 2025
2774312
these two xml properties are now deprecated; harmonize spec language
karenetheridge Sep 18, 2025
ec81bb8
the "example" keyword is now deprecated
karenetheridge Sep 18, 2025
c2b1114
"propertyName" is no longer required
karenetheridge Sep 18, 2025
cbc7821
Merge pull request #4966 from karenetheridge/ether/xml-deprecations
lornajane Sep 18, 2025
16b60f8
Merge pull request #4965 from karenetheridge/ether/v3.2-ABNF-amendments
mikekistler Sep 18, 2025
1919217
Merge pull request #4957 from karenetheridge/ether/v3.2-schema-remnants
lornajane Sep 18, 2025
2c162bf
Adjust the branch for release of 3.2
lornajane Sep 18, 2025
de2325a
Set the publish date
lornajane Sep 19, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4,626 changes: 0 additions & 4,626 deletions src/oas.md
View file
Open in desktop

This file was deleted.

69 changes: 0 additions & 69 deletions src/schemas/validation/README.md
View file
Open in desktop

This file was deleted.

21 changes: 0 additions & 21 deletions src/schemas/validation/dialect.yaml
View file
Open in desktop

This file was deleted.

70 changes: 0 additions & 70 deletions src/schemas/validation/meta.yaml
View file
Open in desktop

This file was deleted.

20 changes: 0 additions & 20 deletions src/schemas/validation/schema-base.yaml
View file
Open in desktop

This file was deleted.

Loading