Skip to content
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.

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

Reorganise tags in OpenAPI spec #214

Open
cmil opened this issue Nov 12, 2023 · 0 comments
Open

Reorganise tags in OpenAPI spec #214

cmil opened this issue Nov 12, 2023 · 0 comments
Milestone

Comments

@cmil
Copy link
Member

cmil commented Nov 12, 2023

Tags could better reflect functionality of the API (see #192)

Technically, I think, the groups are "Tags", right? So you can assign multiple tags to an endpoint which would result in making it show up in several of these groupings. IMHO, it would make sense to introduce more of these, e.g. group endpoints that provide the data for Network Analysis,...
I'm all for improving the readability of the OpenAPI documentation by giving it a clear structure. Maybe we should think about replacing the "public" tag by one or more tags that better serve this purpose then.

This issue was originally part of #194.

@cmil cmil added this to the 1.2.0 milestone Jul 12, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

1 participant