Some schema objects in the OpenAPI specification currently lack example definitions (e.g., TEA Artifact). Providing a concrete example for every schema object, even simple ones, would improve documentation quality and make the API easier to understand and adopt.
Each schema object should include at least one representative example illustrating valid usage.
Some schema objects in the OpenAPI specification currently lack example definitions (e.g., TEA Artifact). Providing a concrete example for every schema object, even simple ones, would improve documentation quality and make the API easier to understand and adopt.
Each schema object should include at least one representative example illustrating valid usage.