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

Upgrade guillotina_swagger to swagger3 #2

Open
AkshJain99 opened this issue Mar 11, 2019 · 8 comments
Open

Upgrade guillotina_swagger to swagger3 #2

AkshJain99 opened this issue Mar 11, 2019 · 8 comments

Comments

@AkshJain99
Copy link

Upgrade guillotina_swagger to swagger3

@AkshJain99
Copy link
Author

OpenAPI 3 support: Along with updating JSON schema validation support, we need to update our swagger documentation to work with OpenAPI 3/swagger 3.

@AkshJain99
Copy link
Author

Change the generator settings: settings.SchemaType = JsonSchemaType.OpenApi3;

@AkshJain99
Copy link
Author

AkshJain99 commented Mar 15, 2019

@vangheem where is the documentation written for guillotina swagger?

@AkshJain99
Copy link
Author

actually I am trying to update documentation to support guillotina with openapi3 /swagger3
but what I actually want to know is , thats why asking for documentation

@vangheem
Copy link
Contributor

Can you be more specific? I'm not sure I understand what you are asking for.

guillotina_swagger pulls in config from service definitions like here: https://github.com/plone/guillotina/blob/master/guillotina/api/content.py#L246

@AkshJain99
Copy link
Author

sorry actually my bad :( i didnt see the comment i did earlier ,
what i was trying to ask is as i want to swagge documentation related to support of open API3 , so where can i find the documentation related to guillotina swagger?

@vangheem
Copy link
Contributor

guillotina_swagger docs are https://github.com/guillotinaweb/guillotina_swagger/blob/master/README.rst

There isn't much to the package--all it's doing is reading configuration, outputting swagger definition and serving swagger html/js.

Swagger docs are here: https://swagger.io/docs/

There are lots of docs on openapi 3.

I hope that helps!

@AkshJain99
Copy link
Author

yes will soon make a commit for this 👍

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

No branches or pull requests

2 participants