You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Right now the OpenAPIController limits the docs to redoc and swagger. it might be a nice idea to allow a normal "route" to serve the main html doc file. allow a controller function in the APIController to render whichever docs template that is required similar to how templating etc work instead of "hard coding" it in.
seems the only way is to keep the OpenAPIController path to /schema for /schema/openapi.json and then add another route to render a template that loads the spec file from /schema/openapi.json. making it openapi front end independent could be a good idea.
adding in more "generic" code and potentially bloating the OpenAPIController. in future even the redocs / swagger can be migrated as "plugin" docs which would actualy make the code base easier to maintain and cleaner
Unresolved questions
No response
Funding
If you would like to see an issue prioritized, make a pledge towards it!
We receive the pledge once the issue is completed & verified
The text was updated successfully, but these errors were encountered:
WilliamStam
changed the title
Enhancement: Allow a normal route for the "docs"
Enhancement: Allow a normal route for the "docs" (custom controller / renderer)
Oct 5, 2023
Summary
Right now the
OpenAPIController
limits the docs to redoc and swagger. it might be a nice idea to allow a normal "route" to serve the main html doc file. allow a controller function in the APIController to render whichever docs template that is required similar to how templating etc work instead of "hard coding" it in.Im really enjoying https://rapidocweb.com/ at the moment.
seems the only way is to keep the
OpenAPIController
path to/schema
for/schema/openapi.json
and then add another route to render a template that loads the spec file from/schema/openapi.json
. making it openapi front end independent could be a good idea.Basic Example
Drawbacks and Impact
adding in more "generic" code and potentially bloating the OpenAPIController. in future even the redocs / swagger can be migrated as "plugin" docs which would actualy make the code base easier to maintain and cleaner
Unresolved questions
No response
Funding
The text was updated successfully, but these errors were encountered: