We are currently adding references to the originating lines in the yaml specs to changelog and breaking changes
Here’s the relevant issue with links to an example: github.com/Tufin/oasdiff/iss…
For go developers: this enhancement is based on a fork of the go-yaml package which adds line and column location information for YAML elements during unmarshalling: github.com/oasdiff/yaml3
Try the new Delta command to calculate a numerical distance value between OpenAPI specs github.com/Tufin/oasdiff/blo…
Becoming a mature API provider is not trivial. Here's an outline of the steps, with focus on change management: oasdiff.com/blog/maturity-mo…
The latest oasdiff release adds the ability to control colored output with `color=auto|always|never`
github.com/Tufin/oasdiff/rel…
You can now generate an OpenAPI changelog in HTML:
oasdiff changelog data/openapi-test1.yaml data/openapi-test3.yaml -f html
We just released a first ever comprehensive list of all breaking changes in OpenAPI: oasdiff.com/blog/formalizing…
Yesterday we merged a major enhancement to the “flatten” feature which merges schemas with “allOf” to reduce false positives in breaking changes. It should now be able to handle circular schema references properly.
Please try it and share your feedback.
github.com/Tufin/oasdiff/blo…
You can now set exceptions to ignore breaking changes in the Components section of OpenAPI spec as well as the previously-supported endpoint changes: github.com/Tufin/oasdiff/blo…
Today we added support for merging allOf subschemas to improve the accuracy of breaking changes detection: github.com/Tufin/oasdiff/blo…
API owners, how do you communicate breaking changes to your consumers?
0%Change the API as needed
0%Increment API version
0%Deprecate and replace
0%Publish a changelog
0 votes • Final resultsWe are giving a talk about oasdiff in the 2023 platform summit.
nordicapis.com/events/platfo…
We just submitted a PR to merge allOf subschemas: github.com/getkin/kin-openap…
oasdiff will leverage this to detect breaking changes in schemas with allOf more accurately.
Do you want to contribute to the oasdiff GitHub action? github.com/oasdiff/oasdiff-a…
We're getting ready to support OpenAPI breaking changes by merging schemas under "allOf". Please help us review the PR: github.com/getkin/kin-openap…


