search

swagger-api / swagger-ui

Swagger UI is a collection of HTML, JavaScript, and CSS assets that dynamically generate beautiful documentation from a Swagger-compliant API.
https://swagger.io
Apache License 2.0
26.47k stars 8.96k forks source link

Community plugin pubblication #8446

Open marc0l92 opened 1 year ago

marc0l92 commented 1 year ago

Hello, I created a plugin for swagger-ui: https://github.com/marc0l92/swagger-ui-flat-model-plugin

Do you have a place where you collect or advertise the community created plugins for this project?

Thanks, Marco

JaredAAT commented 1 year ago

It'd be great to implement something like this: https://www.serverless.com/plugins Which is powered by: https://github.com/serverless/plugins

char0n commented 1 year ago

Hi @marc0l92,

Great job on the plugin!

Do you have a place where you collect or advertise the community created plugins for this project?

We currently don't, but we have wiki where I can create a dedicated section for community contributed plugins. It will be linked directly from the main README.md file. Would that work for you?

It'd be great to implement something like this: https://www.serverless.com/plugins Which is powered by: https://github.com/serverless/plugins

@JaredAAT yeah that would be great, but we have to keep in mind that plugins are related to context. Some plugins can possibly be truly generic, but there might not be much of them. Other plugins are fully specific to SwaggerUI or SwaggerEditor (v4 or v5). We can start with the wiki and we'll see if it kick off.

JaredAAT commented 1 year ago

@JaredAAT yeah that would be great, but we have to keep in mind that plugins are related to context

IMHO, that's just a matter of exposing certain meta data that should be policed by plugin creators themselves, they'll soon get a bunch of issues asking why their plugin doesn't work with whatever version they're using and update the Meta/README.

marc0l92 commented 1 year ago

Hello @char0n , a new section in the wiki will be a perfect starting point.

I did not find many plugins online, so I don't think there is the need to create something more complex if there are no plugins to publish.