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

Unable to change group order with OrderActionsBy when only some group have description #1757

Open
yyjdelete opened this issue Jul 27, 2020 · 3 comments
Labels
p3 Low priority

Comments

@yyjdelete
Copy link

yyjdelete commented Jul 27, 2020

Swashbuckle.AspNetCore 5.5.1

When IncludeXmlComments(..., includeControllerXmlComments: true) is used, but only some controllers have comments, it's unable to change the order of groups with OrderActionsBy(the ones with description is always the first)

Seems Swashbuckle.AspNetCore only gen tags with Description in OpenApiDocument.Tags, and according to https://swagger.io/specification/#fixed-fields,`The tags that are not declared MAY be organized randomly or based on the tools' logic.`

Is there an options to force Swashbuckle.AspNetCore generate all tags?

@yingxinj
Copy link

yingxinj commented Dec 6, 2022

I have just opened a PR #2565 that would fix this issue by adding all Controller tags to the root tags object, not just tags with description, please let me know if it is helpful :) the root tags are then sorted by name as a sensible default, but having the tags object be a complete list means that you can sort them in other ways if preferred.

Copy link
Contributor

github-actions bot commented May 6, 2024

This issue is stale because it has been open for 60 days with no activity. It will be automatically closed in 14 days if no further updates are made.

@github-actions github-actions bot added the stale Stale issues or pull requests label May 6, 2024
@martincostello
Copy link
Collaborator

#2565

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
p3 Low priority
Projects
None yet
Development

No branches or pull requests

4 participants