8000 Feature/swagger-ui-5.21.0 by Simran-B · Pull Request #21685 · arangodb/arangodb · GitHub
[go: up one dir, main page]

Skip to content

Feature/swagger-ui-5.21.0 #21685

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

Closed
wants to merge 4 commits into from
Closed

Feature/swagger-ui-5.21.0 #21685

wants to merge 4 commits into from

Conversation

Simran-B
Copy link
Contributor
@Simran-B Simran-B commented Mar 21, 2025

Scope & Purpose

Update Swagger UI and default to the Schema tab instead of Example Value for better visibility of the structured parameter descriptions

TODO: Find out whether something on our end causes a bug with Swagger UI not reacting to expand/collapse of the Schema in at least one case (the first Authentication endpoint) unless you switch back and forth between the Example Value and Schema tab. Interestingly, if you expand the second endpoint's Schema (might need to the switching tabs trick first), then you can also expand the matching entry for the first endpoint... seems like a React issue, perhaps because the tab isn't properly activated in case of using defaultRenderingMode?)

Possible upstream fix: swagger-api/swagger-ui#10399

Update: This PR now adds a custom build of Swagger-UI 5.21.0 with the patch from PR applied.

  • 🍕 New feature

Checklist

  • Tests
    • Manually tested
  • 📖 CHANGELOG entry made
  • 📚 documentation written (release notes, API changes, ...)
  • Backports
    • Backport for 3.12.0: (Please link PR)
    • Backport for 3.11: (Please link PR)
    • Backport for 3.10: (Please link PR)

Related Information

arangodb/docs-hugo#406

Providing a key for the ModelExample component fixes an issue with broken interactivity
@Simran-B Simran-B changed the title Feature/swagger-ui-5.20.1 Feature/swagger-ui-5.21.0 Apr 29, 2025
@Simran-B
Copy link
Contributor Author
Simran-B commented May 2, 2025

There seems to be a regression? This is how enums used to be displayed:

image

And with the updated Swagger-UI:

image

@Simran-B
Copy link
Contributor Author

Closing for now due to the worse UX

@Simran-B Simran-B closed this May 21, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
1 Feature 3 Documentation 3 Swagger Swagger i 47A8 ntegration, upstream swagger reference cla-signed
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant
0