VRETA

OpenAPI

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

Nullable used to mean one thing and the newer convention means another

Old parts of our spec still use the boolean flag on a property and newer sections use the type array form instead. A reviewer unfamiliar with the history assumes one is a typo and fixes it, breaking a client that depended on the old form. We have a comment at the top of the file explaining the split and half the team still misses it.
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.