Comments (1)
What you are seeing is a limitation in OAS 3.0 and earlier.
In OAS 3.1, $ref
in Schema Objects can have adjacent properties in accordance with the rules of draft 2020-12. For validation keywords, this is just the same as using an allOf
. For annotation keywords like description
, deprecated
, readOnly
, etc., it is up to the application (e.g. Swagger) to decide how to handle the adjacent keywords. They are not necessarily overwrites as not all annotations have the same semantics.
Also in OAS 3.1, $ref
in the Reference Object allows exactly two adjacent keywords: summary
and description
. These are overwrites (unlike in the Schema Object).
Since OAS 3.1 has already addressed this issue, I'm going to close it. For Schema Objects, if you want different behavior from what OAS 3.1 does, you need to file that with JSON Schema as 3.1 just uses standard JSON Schema (unlike 3.0). For Reference Objects, if you want additional adjacent keyword support, please file a specific issue for that.
from openapi-specification.
Related Issues (20)
- Codify the meaning of "undefined" and "implementation-defined" HOT 3
- Use URI references for Security Requirements in 3.2
- remove "Optional OAuth2 security" examples HOT 2
- Style guide / release checklist for the specification HOT 4
- Behavior of `allowEmptyValue: false` HOT 11
- Open Community (TDC) Meeting, Thursday 16 May 2024 HOT 2
- RFC 7231 has been obsoleted by RFC 9110 HOT 10
- Define a policy using draft PRs when waiting on specific approvals HOT 3
- Open Community (TDC) Meeting, Thursday 23 May 2024 HOT 5
- Open Community (TDC) Meeting, Thursday 30 May 2024 HOT 2
- We should not keep a minified version of respec.js HOT 1
- Document milestone usage in DEVELOPMENT.md
- Define and add new process labels and document general label usage in DEVELOPMENT.md
- Should `style: form` examples include `?` prefix? If so, what about `spaceDelimited`, `pipeDelimited`, and `deepObject`? HOT 3
- Simplify HTML rendering build process HOT 1
- Consolidated $ref-to-Some Object feature request
- Move examples to learn.openapis.org or spec.openapis.org HOT 5
- Preserve section links in ReSpec output HOT 1
- Open Community (TDC) Meeting, Thursday 06 June 2024 HOT 1
- Add dark mode support to the HTML versions of the OpenAPI specs HOT 2
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from openapi-specification.