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)
- Open Community (TDC) Meeting, Thursday 11 April 2024 HOT 7
- Reference schema property within a response HOT 2
- Open Community (TDC) Meeting, Thursday 18 April 2024 HOT 5
- Format Registry documentation is not accurate / well published HOT 2
- Schema issues in documentation examples HOT 4
- Add tokenExchange grant type to list of allowed grant types for oauth2 shape
- Open Community (TDC) Meeting, Thursday 25 April 2024 HOT 7
- Define and document our schema publishing process HOT 1
- Schema development: main or branch, in parallel or at release time?
- Should we-organize our GitHub pages to a directory on main?
- Why does the JSON schema for 3.0 specify patternProperties for component names but allows additional properties?
- Support for `multipart/mixed` (and possibly better `multipart/*` support in general) HOT 5
- `description`/`summary` for Paths Object
- Support `multipart/byteranges` for 206 responses
- Support application/json-seq and similar JSON-based sequential formats HOT 1
- Did we break 3.2 compatibility by removing the Path Item $ref special case? HOT 12
- pipeDelimited and spaceDelimited style examples can be unresolvable HOT 10
- Encoding Object `contentType` field: "comma-separated list of the two types"? HOT 8
- Add appendix "Informative references" to published spec documents HOT 4
- Open Community (TDC) Meeting, Thursday 02 May 2024 HOT 3
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.