Support x-tagGroups extension for API tag grouping
N
Nutmeg Porpoise
OpenAPI specifications that use the x-tagGroups extension to organise tags into named parent navigation groups do not produce that grouping in generated API documentation. The x-tagGroups field is not recognised during import and has no effect on the resulting navigation structure. All tags are presented as individual categories or nested categories based on the standard tags array and the > naming convention, regardless of how they were grouped in the spec.
Recognise and process the x-tagGroups extension field in imported OpenAPI specifications and use it to generate top-level navigation group labels in the API reference, with the grouped tags appearing as subcategories beneath each named group.
Benefit: Teams whose existing API specifications use x-tagGroups for navigation grouping - particularly those migrating from tools that support it - can retain their intended documentation structure without restructuring their spec or renaming every tag using the > convention.
Log In