DEV Community

Discussion on: Why use Swagger for creating and documenting APIs

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.

dianamaltseva8 profile image
Diana Maltseva Author

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