Skip to content

Add configuration option to hide "UNTAGGED" categoryΒ #1127

Open
@rickyheijnen

Description

@rickyheijnen

Is your feature request related to a problem?

When generating API documentation using tags, the plugin always displays an "UNTAGGED" category for operations without tags. In some cases, I want to hide this category completely as it creates unnecessary clutter in the documentation.

Describe the solution you'd like

Please add a new configuration parameter showUntagged: boolean (defaulting to true) that allows users to control the visibility of the "UNTAGGED" category. When set to false, operations without tags would be hidden from the documentation.

Describe alternatives you've considered

I've considered filtering the OpenAPI spec before passing it to the plugin, but this requires additional preprocessing steps and doesn't integrate cleanly with the existing workflow.

Additional context

I'm working on documentation for a large API where most endpoints are properly tagged, but a few legacy endpoints remain untagged. I want to present a clean, organized documentation experience that focuses on the properly categorized endpoints while we work on tagging the remaining ones.

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions