-
Notifications
You must be signed in to change notification settings - Fork 9.1k
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.
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
3.1.0 Release #2462
3.1.0 Release #2462
Commits on Oct 8, 2018
-
Configuration menu - View commit details
-
Copy full SHA for 7a5b183 - Browse repository at this point
Copy the full SHA 7a5b183View commit details -
Configuration menu - View commit details
-
Copy full SHA for 77f86eb - Browse repository at this point
Copy the full SHA 77f86ebView commit details
Commits on Oct 18, 2018
-
Configuration menu - View commit details
-
Copy full SHA for e985f13 - Browse repository at this point
Copy the full SHA e985f13View commit details -
Configuration menu - View commit details
-
Copy full SHA for eb92123 - Browse repository at this point
Copy the full SHA eb92123View commit details -
Merge pull request #1715 from MikeRalphson/specext-oas
Note that specification extensions beginning x-oas- are reserved
Configuration menu - View commit details
-
Copy full SHA for 3083f1a - Browse repository at this point
Copy the full SHA 3083f1aView commit details -
Merge pull request #1714 from MikeRalphson/discrim-ext
Allow specification extensions in discriminator object
Configuration menu - View commit details
-
Copy full SHA for 334cf53 - Browse repository at this point
Copy the full SHA 334cf53View commit details
Commits on Feb 6, 2019
-
Configuration menu - View commit details
-
Copy full SHA for d27bb1c - Browse repository at this point
Copy the full SHA d27bb1cView commit details
Commits on Feb 7, 2019
-
Merge pull request #1764 from MikeRalphson/v3.1-mutualTLS
security; add new securityScheme type of mutualTLS
Configuration menu - View commit details
-
Copy full SHA for a76dad5 - Browse repository at this point
Copy the full SHA a76dad5View commit details
Commits on Feb 28, 2019
-
* Fix: #832. Add info.summary. * Fix: summary is shord, description is verbose. Be consistent with other definitions of summary and description.
Configuration menu - View commit details
-
Copy full SHA for 5f6a25a - Browse repository at this point
Copy the full SHA 5f6a25aView commit details
Commits on Jun 21, 2019
-
fix OIDC url and OAuth2 requirements
Signed-off-by: Axel Nennker <axel.nennker@telekom.de>
Configuration menu - View commit details
-
Copy full SHA for 5044418 - Browse repository at this point
Copy the full SHA 5044418View commit details
Commits on Aug 6, 2019
-
Merge pull request #1959 from AxelNennker/fix_OICD_and_OAuth2
fix OIDC url and OAuth2 requirements
Configuration menu - View commit details
-
Copy full SHA for 192aafe - Browse repository at this point
Copy the full SHA 192aafeView commit details
Commits on Oct 21, 2019
-
Update Schema Object to proper JSON Schema
Phil Sturgeon committedOct 21, 2019 Configuration menu - View commit details
-
Copy full SHA for ac236d1 - Browse repository at this point
Copy the full SHA ac236d1View commit details
Commits on Oct 25, 2019
-
update vocab and arbitrary props
Phil Sturgeon committedOct 25, 2019 Configuration menu - View commit details
-
Copy full SHA for f8f92ed - Browse repository at this point
Copy the full SHA f8f92edView commit details
Commits on Oct 28, 2019
-
another go at arbitrary keywords
Phil Sturgeon committedOct 28, 2019 Configuration menu - View commit details
-
Copy full SHA for e121405 - Browse repository at this point
Copy the full SHA e121405View commit details
Commits on Oct 29, 2019
-
Phil Sturgeon committed
Oct 29, 2019 Configuration menu - View commit details
-
Copy full SHA for 5905f45 - Browse repository at this point
Copy the full SHA 5905f45View commit details
Commits on Nov 27, 2019
-
Support style, explode, allowReserved encoding for multipart/form-data (
Configuration menu - View commit details
-
Copy full SHA for 0ec2c73 - Browse repository at this point
Copy the full SHA 0ec2c73View commit details
Commits on Jan 9, 2020
-
default should match json schema
Phil Sturgeon committedJan 9, 2020 Configuration menu - View commit details
-
Copy full SHA for 4822592 - Browse repository at this point
Copy the full SHA 4822592View commit details -
removed json schema keyworld list, its just all of em.
Phil Sturgeon committedJan 9, 2020 Configuration menu - View commit details
-
Copy full SHA for d67f350 - Browse repository at this point
Copy the full SHA d67f350View commit details -
Phil Sturgeon committed
Jan 9, 2020 Configuration menu - View commit details
-
Copy full SHA for bb9a6f2 - Browse repository at this point
Copy the full SHA bb9a6f2View commit details -
Merge pull request #1977 from philsturgeon/json-schema-update
Update Schema Objects to JSON Schema Draft 2019-09
Configuration menu - View commit details
-
Copy full SHA for e3c236a - Browse repository at this point
Copy the full SHA e3c236aView commit details
Commits on Jan 10, 2020
-
Correct Styles Values for spaceDelimited and pipeDelimited, as based …
…on Style Examples, they support objects.
Configuration menu - View commit details
-
Copy full SHA for fd39bcd - Browse repository at this point
Copy the full SHA fd39bcdView commit details
Commits on Jan 16, 2020
-
Add support for webhooks as a top-level element (#2103)
* Add webhooks as a top-level element to the spec * Add the changes from #2048 and signpost webhooks * Add an example of webhooks * Relocate and expand on webhooks section following feedback * Better wording to describe expectations on API consumers * Clearer wording for why the paths element is here * Update language to make callbacks clearer
Configuration menu - View commit details
-
Copy full SHA for 61f9d7e - Browse repository at this point
Copy the full SHA 61f9d7eView commit details
Commits on Feb 6, 2020
-
Align the OAS 3.1 nullable language with the 3.0.3 (#2115)
This adapts the language from PR #2046, with minimal wording tweaks to account for type now being able to have multiple values (type arrays).
Configuration menu - View commit details
-
Copy full SHA for 3cb92bd - Browse repository at this point
Copy the full SHA 3cb92bdView commit details -
Configuration menu - View commit details
-
Copy full SHA for c37a305 - Browse repository at this point
Copy the full SHA c37a305View commit details -
Reference Object and Schema Object use of $ref updates for 2019-09 / …
…OAS 3.1 (#2107) * Checkpoint of draft * Fix typo. Co-Authored-By: Darrel <darrmi@microsoft.com> * Fix plural anchor Co-Authored-By: Mike Ralphson <mike.ralphson@gmail.com> * Remove superfluous specification Co-Authored-By: Phil Sturgeon <me@philsturgeon.uk> Co-authored-by: Darrel <darrmi@microsoft.com> Co-authored-by: Mike Ralphson <mike.ralphson@gmail.com> Co-authored-by: Phil Sturgeon <me@philsturgeon.uk>
Configuration menu - View commit details
-
Copy full SHA for 92a9104 - Browse repository at this point
Copy the full SHA 92a9104View commit details
Commits on Feb 21, 2020
-
Configuration menu - View commit details
-
Copy full SHA for c376bef - Browse repository at this point
Copy the full SHA c376befView commit details
Commits on Feb 27, 2020
-
Configuration menu - View commit details
-
Copy full SHA for 70ecce7 - Browse repository at this point
Copy the full SHA 70ecce7View commit details
Commits on Mar 11, 2020
-
Configuration menu - View commit details
-
Copy full SHA for c6415fe - Browse repository at this point
Copy the full SHA c6415feView commit details
Commits on Mar 19, 2020
-
Make paths object optional (#1781)
* Make paths object optional * Adding reusable Path Item Objects Under `components` * Adopt DM's suggested change to OpenAPI doc definition * Cleanup use of specification and definition where we mean document * multipartite>composite, define ACL * Add ' | Reference Object' to callbacks/webhooks Co-authored-by: Ron <ron@swagger.io>
Configuration menu - View commit details
-
Copy full SHA for a6b99bc - Browse repository at this point
Copy the full SHA a6b99bcView commit details -
Fwd port v3.0.3 dev to v3.1.0 dev (#2163)
* fix typo in Callback Object Signed-off-by: Mike Ralphson <mike.ralphson@gmail.com> * retain typo in v3.0.2; fix for v3.0.3 (#1899) Signed-off-by: Mike Ralphson <mike.ralphson@gmail.com> * Clarify empty Security Requirement Object usage and validity (#1886) * Clarify empty Security Requirement Object usage and validity * Reorder sentences to make clearer. * Remove wrong text. * Removed unneeded text. Co-authored-by: Ron <ron@swagger.io> Signed-off-by: Mike Ralphson <mike.ralphson@gmail.com> * Ron's wording for Darrels feedback Signed-off-by: Mike Ralphson <mike.ralphson@gmail.com> * ted updates Signed-off-by: Mike Ralphson <mike.ralphson@gmail.com> * Replace 'application' by 'API' within the 'Info Object' definition. (#2004) Signed-off-by: Mike Ralphson <mike.ralphson@gmail.com> * Path Templating Clarification - proposed fix for #1830. (#1831) * Proposed fix for #1830. Each variable expression in a path must have a corresponding path parameter. * #1830 - Removed 'at least once' to defer the question about repeated references to a single path parameter. * Update #1830 fix with suggestion from Darrel @darrelmiller suggestions we use "template expression" instead of "variable expression" to align with RFC6570. Good idea. Signed-off-by: Mike Ralphson <mike.ralphson@gmail.com> * yaml.org supports https, but www.yaml.org is misconfigured Signed-off-by: Mike Ralphson <mike.ralphson@gmail.com> * Updated text for OperationRef Signed-off-by: Mike Ralphson <mike.ralphson@gmail.com> * fix a typo in the Security Filtering section (#1837) * fix a typo in the Security Filtering section * Security filtering slight reword Co-authored-by: Mike Ralphson <mike.ralphson@gmail.com> Signed-off-by: Mike Ralphson <mike.ralphson@gmail.com> * Make ABNF for runtime expressions complete Signed-off-by: Mike Ralphson <mike.ralphson@gmail.com> * Explain unclear semantics of property `$ref` in Path Item Object (#1964) * Explain unclear semantics of property `$ref` in Path Item Object Currently, as explained in #1038 (comment) the description of `$ref` in [Path Item Object](https://github.com/OAI/OpenAPI-Specification/blob/3.0.2/versions/3.0.2.md#pathItemObject) is unclear about the semantics behing it. I took the explaination from issue #1038 to make it more clear. * Update versions/3.1.0.md Co-authored-by: Ron <ron@swagger.io> Signed-off-by: Mike Ralphson <mike.ralphson@gmail.com> * Clarify constraints on Security Scheme Object Scheme Property (#1880) * Wording around scheme extensions * Clarified that securitySchemeScheme is only a SHOULD be registered scheme Signed-off-by: Mike Ralphson <mike.ralphson@gmail.com> * fix difference between yaml and json in Response Object Examples Signed-off-by: Mike Ralphson <mike.ralphson@gmail.com> * Server Variable Object clarifications (#1809) * Server Variable Object clarifications * Toned language down for proper semver versioning Signed-off-by: Mike Ralphson <mike.ralphson@gmail.com> * Fix formatting errors in example (#2132) Signed-off-by: Mike Ralphson <mike.ralphson@gmail.com> * Update 3.0.3 for release (#2149) * Update README.md for release * Update release date for 3.0.3 Signed-off-by: Mike Ralphson <mike.ralphson@gmail.com> * Update versions/3.1.0.md Co-Authored-By: Darrel <darrmi@microsoft.com> Signed-off-by: Mike Ralphson <mike.ralphson@gmail.com> * Fixed typo Signed-off-by: Mike Ralphson <mike.ralphson@gmail.com> * explicit 'forward slash' Signed-off-by: Mike Ralphson <mike.ralphson@gmail.com> * fix #2053: `style` keyword is not supported inside Schema object Signed-off-by: Mike Ralphson <mike.ralphson@gmail.com> * OpenAPI not Open API Signed-off-by: Mike Ralphson <mike.ralphson@gmail.com> * backticks Signed-off-by: Mike Ralphson <mike.ralphson@gmail.com> * minor clarification for operationId usage in link objects (#1733) * minor clarification it's a bit confusing that both the id and the reference are called "operationId", so this tweak makes the text a bit more explicit. * use right terminology Co-Authored-By: Mike Ralphson <mike.ralphson@gmail.com> Co-authored-by: Ron <ron@swagger.io> Co-authored-by: Mike Ralphson <mike.ralphson@gmail.com> Signed-off-by: Mike Ralphson <mike.ralphson@gmail.com> * Update 3.1.0.md fixed typo Signed-off-by: Mike Ralphson <mike.ralphson@gmail.com> * Removed confusing comment Signed-off-by: Mike Ralphson <mike.ralphson@gmail.com> * Clarify the spec to allow optional or unspecified OAuth scopes (#1888) * Referencing issue #513. Clarify the spec to accommodate OAuth schemes where scope may be unspecified (optional scope) or where scope is not used at all. * Removed the provision for default scope represented as empty string. This introduces some ambiguities in the Security Requirement Object that would need to be addressed. * For #513, adjusting language and removing examples For #513, adjusting language and removing examples as suggested by @webron. * removed unnecessary example header Co-authored-by: Ron <ron@swagger.io> Signed-off-by: Mike Ralphson <mike.ralphson@gmail.com> * The examples keyword is not supported inside schema (#2042) * examples not supported inside schema * figured it out * a tiny little edit Signed-off-by: Mike Ralphson <mike.ralphson@gmail.com> * Fix 'Security Scheme Object' definition with OAuth 2.0 grant types. (#2006) Signed-off-by: Mike Ralphson <mike.ralphson@gmail.com> * Fix formatting errors in example (#2132) Signed-off-by: Mike Ralphson <mike.ralphson@gmail.com> Co-authored-by: seiya <r108338@yahoo.co.jp> Co-authored-by: Adam Leventhal <ahl@transposit.com> Co-authored-by: Sebastián Ramírez <tiangolo@gmail.com> Co-authored-by: Ron <ron@swagger.io> Co-authored-by: Phil Sturgeon <me@philsturgeon.uk> Co-authored-by: Patrice Krakow <patrice.krakow@gmail.com> Co-authored-by: Ted Epstein <ted.epstein@reprezen.com> Co-authored-by: Darrel Miller <darrmi@microsoft.com> Co-authored-by: Carsten Brandt <mail@cebe.cc> Co-authored-by: Henry Andrews <andrews_henry@yahoo.com> Co-authored-by: Sergej <sergej2705@users.noreply.github.com> Co-authored-by: nasa9084 <nasa.9084.bassclarinet@gmail.com> Co-authored-by: Erik Wilde <dret@users.noreply.github.com>
Configuration menu - View commit details
-
Copy full SHA for b5a15df - Browse repository at this point
Copy the full SHA b5a15dfView commit details -
Configuration menu - View commit details
-
Copy full SHA for b45d0d8 - Browse repository at this point
Copy the full SHA b45d0d8View commit details
Commits on Mar 26, 2020
-
Configuration menu - View commit details
-
Copy full SHA for cafadc9 - Browse repository at this point
Copy the full SHA cafadc9View commit details
Commits on Apr 9, 2020
-
Merge pull request #2101 from Arhimenrius/correct-style-values-types
Correct Styles Values for spaceDelimited and pipeDelimited, as based …
Configuration menu - View commit details
-
Copy full SHA for 6abda3b - Browse repository at this point
Copy the full SHA 6abda3bView commit details -
Co-authored-by: Phil Sturgeon <me@philsturgeon.uk>
Configuration menu - View commit details
-
Copy full SHA for 1a8d44f - Browse repository at this point
Copy the full SHA 1a8d44fView commit details
Commits on May 6, 2020
-
While going over the changes for the release notes, found two issues: - The TOC entry for `Relative references in URIs` was not modified to match the change in the spec. - The `Paths Object` had an extra sentence that should have not been there (referencing sub-documents and overlays).
Configuration menu - View commit details
-
Copy full SHA for d5b65bb - Browse repository at this point
Copy the full SHA d5b65bbView commit details
Commits on May 7, 2020
-
Merge pull request #2224 from OAI/Missing-updates
Missing updates
Configuration menu - View commit details
-
Copy full SHA for 3678d30 - Browse repository at this point
Copy the full SHA 3678d30View commit details
Commits on May 14, 2020
-
Remove boolean compatibility for exclusive* (#2226)
This brings exclusiveMinimum, exclusiveMaximum, minimum, and maximum, into full modern JSON Schema compatibility. There are no edits directly mentioning minimum and maximum, but removing the boolean form simplifies their processing by making it context-independent.
Configuration menu - View commit details
-
Copy full SHA for ece5497 - Browse repository at this point
Copy the full SHA ece5497View commit details
Commits on May 28, 2020
-
Update "format" and "content*" for new JSON Schema (#2200)
* Update "format" and "content*" for new JSON Schema This removes OAS formats and examples that are now superfluous as they are part of the 2019-09 JSON Schema draft. Similarly it deprecates the "byte" and "binary" formats in favor of JSON Schema's "contentEncoding" and "contentMediaType" keywords, and updates various related exapmles and other guidance. It also removes confusingly blank rows in the OAS format table. * "format" is an annotation * Fix broken table, type, in Encoding Object Broke some things while updating for "content*" * Fix format of `format` Backticks, not double quotes. * Remove unneeded detail on "format" This was just duplicating info from the JSON Schema spec. Co-authored-by: Darrel <darrmi@microsoft.com> * Remove "byte" and "binary" formats altogether. Instead of just deprecating. The "content*" keywords now cover these use cases. * Harmonize JSON Schema content* + Media Type Object Includes harmonizing with the Encoding Object. In general, OpenAPI objects set the media type, although there is a case for `contentMediaType` with multipart/form-data. Otherwise, `contentEncoding` replaces the now-removed custom formats. A possibly controversial change is to indicate unencoded binary data by omitting `type` (or omitting the schema altogether), as binary data does not conform to JSON string requirements. This could still be done with `type: string` if that is preferred. It's going to be a bit weird either way. I can add wording in the next JSON Schema draft to clarify whichever approach makes more sense. * Fix typos from review * Remove stray {} * Fix inconsistencies contentMediaType and Encoding Object Co-authored-by: Darrel <darrmi@microsoft.com>
Configuration menu - View commit details
-
Copy full SHA for 69662e4 - Browse repository at this point
Copy the full SHA 69662e4View commit details -
[3.1.0-dev] drop OAS semver requirement (#2243)
* drop OAS semver requirement * Update versions/3.1.0.md Co-authored-by: Darrel <darrmi@microsoft.com>
Configuration menu - View commit details
-
Copy full SHA for 835a18f - Browse repository at this point
Copy the full SHA 835a18fView commit details -
Configuration menu - View commit details
-
Copy full SHA for ee77d2d - Browse repository at this point
Copy the full SHA ee77d2dView commit details
Commits on Jun 4, 2020
-
Configuration menu - View commit details
-
Copy full SHA for 5e48cd6 - Browse repository at this point
Copy the full SHA 5e48cd6View commit details
Commits on Jun 18, 2020
-
Configuration menu - View commit details
-
Copy full SHA for 3a96dfe - Browse repository at this point
Copy the full SHA 3a96dfeView commit details
Commits on Jul 23, 2020
-
* chore: explain how $schema might work * reordered and made it specifically only schema resources * Update versions/3.1.0.md Co-authored-by: Karen Etheridge <ether@cpan.org> * Update versions/3.1.0.md Co-authored-by: Ben Hutton <relequestual@gmail.com> * new approach Co-authored-by: Phil Sturgeon <me@philsturgeon.uk> Co-authored-by: Karen Etheridge <ether@cpan.org> Co-authored-by: Ben Hutton <relequestual@gmail.com>
Configuration menu - View commit details
-
Copy full SHA for df7f5f9 - Browse repository at this point
Copy the full SHA df7f5f9View commit details
Commits on Aug 27, 2020
-
Configuration menu - View commit details
-
Copy full SHA for f997bca - Browse repository at this point
Copy the full SHA f997bcaView commit details -
v3.1.0: rephrase data-type section because
format
keyword can be us……ed for any data type. (#2302) * The JSON schema specification states the format keyword can be used for any data type, not just primitive types * The JSON schema specification states the format keyword can be used for any data type, not just primitive types
Configuration menu - View commit details
-
Copy full SHA for 912ef8d - Browse repository at this point
Copy the full SHA 912ef8dView commit details
Commits on Sep 3, 2020
-
Added change to address #2287 (#2328)
Co-authored-by: Darrel Miller <darrel.miller@microsoft.com>
Configuration menu - View commit details
-
Copy full SHA for 437b407 - Browse repository at this point
Copy the full SHA 437b407View commit details -
Make Server Variable Object's properties more strict (#2335)
Followup to #1809, now that we allow breaking changes.
Configuration menu - View commit details
-
Copy full SHA for 280ae0e - Browse repository at this point
Copy the full SHA 280ae0eView commit details
Commits on Sep 4, 2020
-
Configuration menu - View commit details
-
Copy full SHA for 99ceb0b - Browse repository at this point
Copy the full SHA 99ceb0bView commit details
Commits on Sep 17, 2020
-
Configuration menu - View commit details
-
Copy full SHA for 4ad45ad - Browse repository at this point
Copy the full SHA 4ad45adView commit details
Commits on Oct 1, 2020
-
Removed required constraint on responses object (#2329)
Co-authored-by: Darrel Miller <darrel.miller@microsoft.com>
Configuration menu - View commit details
-
Copy full SHA for 7fc06e0 - Browse repository at this point
Copy the full SHA 7fc06e0View commit details
Commits on Oct 7, 2020
-
Merge pull request #2352 from hkosova/comment-indent-fix
Fix indentation of a YAML comment
Configuration menu - View commit details
-
Copy full SHA for 0e91fe8 - Browse repository at this point
Copy the full SHA 0e91fe8View commit details
Commits on Oct 8, 2020
-
3.1.0-rc1 Release prep (#2369)
* Update 3.1.0.md * Merge branch 'master' into v3.1.0-dev
Configuration menu - View commit details
-
Copy full SHA for 8da2c2a - Browse repository at this point
Copy the full SHA 8da2c2aView commit details -
Configuration menu - View commit details
-
Copy full SHA for 9d59a51 - Browse repository at this point
Copy the full SHA 9d59a51View commit details
Commits on Oct 14, 2020
-
Added words relating to adopting semantics of JSON Schema (#2330)
* Added words relating to adopting semantics of JSON Schema * Update versions/3.1.0.md Co-authored-by: Mike Ralphson <mike.ralphson@gmail.com> * Update versions/3.1.0.md Co-authored-by: Mike Ralphson <mike.ralphson@gmail.com> Co-authored-by: Darrel Miller <darrel.miller@microsoft.com> Co-authored-by: Mike Ralphson <mike.ralphson@gmail.com>
Configuration menu - View commit details
-
Copy full SHA for d8d8132 - Browse repository at this point
Copy the full SHA d8d8132View commit details
Commits on Oct 15, 2020
-
Configuration menu - View commit details
-
Copy full SHA for 88e533a - Browse repository at this point
Copy the full SHA 88e533aView commit details
Commits on Oct 29, 2020
-
Configuration menu - View commit details
-
Copy full SHA for 2eeb16d - Browse repository at this point
Copy the full SHA 2eeb16dView commit details
Commits on Nov 5, 2020
-
Merge pull request #2375 from MikeRalphson/v3.1-fix-rc
fix typo in release history table
Configuration menu - View commit details
-
Copy full SHA for 180edfc - Browse repository at this point
Copy the full SHA 180edfcView commit details -
Merge pull request #2388 from MikeRalphson/styleValuesLink
fix link to style values in serialization table
Configuration menu - View commit details
-
Copy full SHA for 2f1e906 - Browse repository at this point
Copy the full SHA 2f1e906View commit details -
Merge pull request #2256 from MikeRalphson/oai-prefix-31
[v3.1.0-dev] reserve both x-oas- and x-oai- prefixes
Configuration menu - View commit details
-
Copy full SHA for a1bdb38 - Browse repository at this point
Copy the full SHA a1bdb38View commit details -
Configuration menu - View commit details
-
Copy full SHA for 33a83e7 - Browse repository at this point
Copy the full SHA 33a83e7View commit details -
Configuration menu - View commit details
-
Copy full SHA for 14121a1 - Browse repository at this point
Copy the full SHA 14121a1View commit details -
Added link to JSON Schema Validation docs explain which formats are i…
…ncluded in JSON Schema (#2394) * Added link to JSON Schema Validation docs explain which formats are included in JSON Schema * Update verbiage to be more accurate Co-authored-by: Mike Ralphson <mike.ralphson@gmail.com> Co-authored-by: Mike Ralphson <mike.ralphson@gmail.com>
Configuration menu - View commit details
-
Copy full SHA for 05de2c4 - Browse repository at this point
Copy the full SHA 05de2c4View commit details
Commits on Nov 12, 2020
-
Improve wording about 'summary' and 'description' in Reference Object
Configuration menu - View commit details
-
Copy full SHA for 99eabdf - Browse repository at this point
Copy the full SHA 99eabdfView commit details
Commits on Nov 19, 2020
-
long descriptions are cool too (#2408)
Co-authored-by: Phil Sturgeon <me@philsturgeon.uk>
Configuration menu - View commit details
-
Copy full SHA for 862a8e3 - Browse repository at this point
Copy the full SHA 862a8e3View commit details
Commits on Dec 3, 2020
-
Unescaped Slashes Aint Welcome Around 'Ere (#2218)
* oas 3.0 doesn't mention slashes not allowed * none of those either Co-authored-by: Phil Sturgeon <me@philsturgeon.uk>
Configuration menu - View commit details
-
Copy full SHA for a50af3a - Browse repository at this point
Copy the full SHA a50af3aView commit details
Commits on Jan 7, 2021
-
Configuration menu - View commit details
-
Copy full SHA for 1f11d02 - Browse repository at this point
Copy the full SHA 1f11d02View commit details -
Configuration menu - View commit details
-
Copy full SHA for 1cd5687 - Browse repository at this point
Copy the full SHA 1cd5687View commit details -
OAS schema dialect clarifications (#2399)
* OAS schema dialect clarifications * OAS schema dialect clarifications Signed-off-by: Mike Ralphson <mike.ralphson@gmail.com> * $schema is allowed in subschemas when bundling Co-authored-by: Ben Hutton <relequestual@gmail.com> * Schema dialect clarifications from Ben Signed-off-by: Mike Ralphson <mike.ralphson@gmail.com> * Use top-level jsonSchemaDialect field Co-authored-by: Ben Hutton <relequestual@gmail.com>
Configuration menu - View commit details
-
Copy full SHA for 478607b - Browse repository at this point
Copy the full SHA 478607bView commit details
Commits on Jan 21, 2021
-
Update JSON Schema Draft to 2020-12 and make $ref resolution rules ex…
…plicit (#2437) * fix http link to json-schema.org Signed-off-by: Mike Ralphson <mike.ralphson@gmail.com> * fix http link to spec.commonmark.org Signed-off-by: Mike Ralphson <mike.ralphson@gmail.com> * Specify rules for $ref resolution Signed-off-by: Mike Ralphson <mike.ralphson@gmail.com> * Specify relative resolution rules for pathItem $ref and example externalValue Signed-off-by: Mike Ralphson <mike.ralphson@gmail.com> * Update JSON Schema draft links to 2020-12 IETF pages Signed-off-by: Mike Ralphson <mike.ralphson@gmail.com> * Make language about 'MUST be in the form of a ...' consistent Signed-off-by: Mike Ralphson <mike.ralphson@gmail.com> * Make it clear pathItem $refs don't need to be external now Signed-off-by: Mike Ralphson <mike.ralphson@gmail.com> * Make RFC links consistent with regard to spacing Signed-off-by: Mike Ralphson <mike.ralphson@gmail.com> * Allow a URI for example.externalValue fields This makes it fall under the rules for relative references. Signed-off-by: Mike Ralphson <mike.ralphson@gmail.com> * Explicitly call out $ref as a Relative Reference * Remove wording about what implementations SHOULD/MAY do with a $ref * Prefer 'referenced document' to 'referrant document' for clarity * Fix JSON Schema $ref resolution fallback rule * Add links back to #relativeReferences definition * Split #relativeReferences definition into URL and URI sections Signed-off-by: Mike Ralphson <mike.ralphson@gmail.com>
Configuration menu - View commit details
-
Copy full SHA for 73098f2 - Browse repository at this point
Copy the full SHA 73098f2View commit details -
Clean-up wording about $refs in responsesObjects, fixes #1679 (#2442)
Configuration menu - View commit details
-
Copy full SHA for 616ef88 - Browse repository at this point
Copy the full SHA 616ef88View commit details
Commits on Feb 4, 2021
-
Configuration menu - View commit details
-
Copy full SHA for 5c8a0b6 - Browse repository at this point
Copy the full SHA 5c8a0b6View commit details
Commits on Feb 11, 2021
-
Fix, clarify, and simplify content type schemas (#2351)
* Fix, clarify, and simplify content type schemas This fixes #2349, which caught that an encoded PNG image is encoded into a text media type. In the process I realized some other errors, and simplified things. * HTTP `Content-Type` is always handled by OAS * Media Type Object key in most cases * Encoding object (possibly inferred from schema) in `multipart/form-data` * HTTP-level `Content-Encoding` is always handled by the OAS Header Object * JSON Schema "content*" is used for embedding one media type into another * the encoded resource is of media type `text/plain` * `"contentMediaType"` is the embedded media type after decoding * `"contentEncoding"` is how to encode/decode binary to/from text This removes any chance of `"contentMediaType"` conflicting with the Media Type Object key or with `contentType` in the Encoding Object, as they now always do different things. Likewise, the HTTP `Content-Encoding` header (with values like gzip, deflate, etc.) does different things than `"contentEncoding"` (which has values like base64, base64url, quoted-printable, etc.). The deprecated part header `Content-Transfer-Encoding` is likewise handled in the Encoding Object, but is probably never used. * Fix Content-Type to indicate semantics ...rather than literal content format on the wire. * Update 3.1.0.md Fixed a typo and changed a SHOULD to MAY. * Update versions/3.1.0.md * clarify default encoding content type value. * Describe interaction between JSON Schema contentEncoding and HTTP Content-Encoding header Co-authored-by: Mike Kistler <mkistler@us.ibm.com> Co-authored-by: Darrel <darrmi@microsoft.com> Co-authored-by: Mike Kistler <mkistler@us.ibm.com>
Configuration menu - View commit details
-
Copy full SHA for 7ee1ca2 - Browse repository at this point
Copy the full SHA 7ee1ca2View commit details
Commits on Feb 15, 2021
-
Configuration menu - View commit details
-
Copy full SHA for d6443c1 - Browse repository at this point
Copy the full SHA d6443c1View commit details
Commits on Feb 16, 2021
-
reframing
user
asauthor
(#2463)Per comment in review, authors determine whether a spec is a single or multipart document. Those who consume the spec care more about the information itself and less (or not at all directly) about how it was assembled.
Configuration menu - View commit details
-
Copy full SHA for 8b97717 - Browse repository at this point
Copy the full SHA 8b97717View commit details -
Configuration menu - View commit details
-
Copy full SHA for f9e313d - Browse repository at this point
Copy the full SHA f9e313dView commit details -
Configuration menu - View commit details
-
Copy full SHA for 547ca88 - Browse repository at this point
Copy the full SHA 547ca88View commit details