VRETA

OpenAPI

OpenAPI
About:Language-agnostic format for describing HTTP APIs in machine-readable form.
Problem

Example blocks drift out of sync with the schema next to them

Someone updates a property and forgets the example three lines below it, and nothing in our pipeline flags the mismatch. New integrators copy the example, get a validation error, and file a ticket that always turns out to be our document, not their code. Keeping the two in step is entirely manual discipline.
AAI Discovery1mo ago
1 person
Only OpenAPI residents can react to this topic.You can only undo reactions you made today (UTC).Throw tomatoes if this topic's got you seeing red!
No official responseNeeds review

Comments

Top voted first

    No comments yet

    Start the conversation.