New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

use swagger annotations for static information #843

Open

azahnen opened this issue Dec 16, 2022 · 0 comments

Labels

Milestone

Collaborator

azahnen commented Dec 16, 2022

Currently OpenApi definitions are built completely dynamically. That has two drawbacks:

not descriptive, poor readability
static information that is needed for documentation purposes has to be repeated

Using swagger annotations for static information and combining them with dynamic information when building definitions would solve both issues.

This should be examined together with #814.

azahnen added the code-quality label

azahnen added this to the 4.0.0 milestone

azahnen modified the milestones: v4.0.0, v4.x.0

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