DEV Community

Discussion on: Why use Swagger for creating and documenting APIs

Collapse
 
colinmtech profile image
Colin Morgan

Is there a convenient way to break swagger docs into multiple files? I have a really hard time reading and working in huge monolithic JSON/yaml files. I found that, even for moderate sized APIs, the swagger doc became ridiculously large and difficult to work with.

I like the idea of swagger, I just don't use it because I become so frustrated trying to maintain it.

Collapse
 
dianamaltseva8 profile image
Diana Maltseva

You can delve into the issue by checking out this link stackoverflow.com/questions/355479.... Here you'll find how to generate documentation using swashbuckle for WebApi 2.