Re:K3s: Kubernetes without the features I don't care about
by zeptomu on Thursday September 27, 2018 @06:53AM
(#18083363)
Agreed. I don't really get the love for swagger, everything about it seems so meta. People say you get documentation for free, but auto generating some fancy webpage out of code (or the swagger spec) is not really documentation.
You have to write your documentation in a real human language. Maybe I just don't get the point of swagger.
Just dead weight otherwise. You can always add it later if people really need it.
True, Swagger docs can be helpful, but also if present but rubbish ignored swagger docs with missing features or side effects is more confusing. Just talk.