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

Open API Schema - for Redocly #820

Merged
merged 6 commits into from
Jun 17, 2023
Merged

Open API Schema - for Redocly #820

merged 6 commits into from
Jun 17, 2023

Conversation

karkir0003
Copy link
Member

API documentation migrating to Redocly instead of local Swagger UI

What user problem are we solving?
Swagger UI too confusing to setup and the UI looks a bit ugly. Fortunately, there is a better solution called Redocly.
What solution does this PR provide?
Provide the /openapi directory containing our api documentation for Redocly to ingest and display beautifully

Testing Methodology

  • Validation of *.yaml files under openapi/ directory using VSCode
  • Open API Validation Github Action that runs on push or pull request of any files under openapi/
    Any other considerations
    make sure redocly works for our case and we aren't incurring extra cost

@karkir0003 karkir0003 changed the title Redocly attempt Open API Schema - for Redocly Jun 17, 2023
@karkir0003 karkir0003 marked this pull request as ready for review June 17, 2023 15:37
@karkir0003 karkir0003 merged commit 7bfba5a into nextjs Jun 17, 2023
6 checks passed
@farisdurrani farisdurrani deleted the redocly-attempt branch June 17, 2023 16:24
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

2 participants