Skip to content

add 3.2 tags example#194

Open
miqui wants to merge 4 commits intoOAI:mainfrom
miqui:tag-3.2-example
Open

add 3.2 tags example#194
miqui wants to merge 4 commits intoOAI:mainfrom
miqui:tag-3.2-example

Conversation

@miqui
Copy link
Copy Markdown
Contributor

@miqui miqui commented Mar 17, 2026

This pull request introduces a new example for OpenAPI 3.2.0 demonstrating advanced tag usage in API documentation, specifically for a "Flight API". The changes include both JSON and YAML versions of the example, as well as a corresponding markdown documentation file.

New Flight API example demonstrating advanced tag usage:

Example files:

  • Added 3.2-tags-example.json and 3.2-tags-example.yaml files illustrating the use of hierarchical tags (including parent-child relationships), tag kinds (such as nav and badge), and external documentation links for tags in an OpenAPI 3.2.0 specification. [1] [2]

Documentation:

  • Added 3.2-tags-example.md to provide documentation and context for the new example, integrating it into the site's example API descriptions.

Copy link
Copy Markdown
Member

@baywet baywet left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

thanks for putting this together

@miqui miqui requested a review from baywet March 19, 2026 20:24
@miqui
Copy link
Copy Markdown
Contributor Author

miqui commented Mar 19, 2026

@ralfhandl if you have a moment....thanks

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants