GithubHelp home page GithubHelp logo

Comments (1)

veronicagg avatar veronicagg commented on July 28, 2024

I've pushed all the examples I generated to a branch in my fork for reference at https://github.com/veronicagg/azure-rest-api-specs/tree/examples-from-recordings
There should be a folder in the api-version folder called swagger-with-examples, which includes examples and the edited swagger file (if there were recordings available for that service). It's not the idea to merge this code up (at least not now), but to have our generated examples (from .net recordings) available, so I just pushed them to that folder under each spec.

I've run lots of the examples through the validation tool, I've opened issues for many specs. As I extracted some patterns from the issues like "required properties are not coming back in responses" or "properties come back as null which doesn't match the spec'd type", instead of opening issues for all those, I'm writing up some proposals first on how we could resolve those, so we can publish them for service teams.
One of the proposals is already at Azure/azure-rest-api-specs#790

Additionally, we need to think of ways to consolidate the errors in an output that's more readable and less repeated errors, to make it less noisy and more actionable.

from oav.

Related Issues (20)

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo 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.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.