Comments (2)
darrelmiller
commented on June 2, 2024
2
Hi @Tomiha Allowing description and summary alongside the $ref was one of the major reasons why we needed to move to V2. In V1 we replace reference objects with their target object in the model, so it was impossible to store additional information in the reference object because that object was removed at resolution time. With the proxy model we use in v2, we have a place to store the additional information.
The good news is that we are finally getting close to shipping a preview of v2. It has been a long journey. V3.1 is a tricky implementation. Also, we would never ship a partial v3.1 implementation as that would be confusing to customers.
from openapi.net.
Tomiha
commented on June 2, 2024
I see that OpenAPI 3.1 support will be added in the v2.0.0 release.
Does that mean that it will never be part of v1.x.x?
Would be nice to have some minimal OpenAPI 3.1 features in the v1.x.x (like the one mentioned above) because v2.0.0 has breaking changes of course and would require an extensive refactor when switching from v1.x.x to v2.0.0.
from openapi.net.
Related Issues (20)
- Sync v2 with vnext branch
- OpenAPI 3.1 to Swagger 2.0 conversion
- Post v2 Preview Checklist
- Use JsonSchema.NET to perform JSON schema validation
- Add wrapper type over JSON schema provided by System.Text.Json HOT 1
- Resolve `JsonSchemas` references with `$id` value pointers
- Initialization of StreamReader in OpenApiStreamReader throws an ArgumentNullException HOT 2
- Warning 'Data and type mismatch found.' with 'date-time' format HOT 5
- hidi transform CSDL with ContainsTarget="true" infinite loop HOT 1
- Example value of an empty OpenApiArray disappears after serialization
- Error deserializing a ChatMessage HOT 1
- Typo in `IsFragrament` HOT 2
- Slack link 404
- Get operation by ID or ref
- Consider adding `Path` and `Type` properties to `OpenApiOperation` HOT 1
- Update `MapOpenApiPrimitiveTypeToSimpleType` to handle integers and numbers without a format HOT 2
- Concurrency error with reader registry
- Implement JSON schema serialization/deserialization
- Parameters defined using a `$ref` are not included in the OpenApiPathItem.Parameters collection HOT 1
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.net.