3 ms·
In my experience (we have a product where people upload Swagger files), most people write it by hand. There's two reasons: 1) Many people use Swagger to design
by gkoberger 10y ago
In my experience (we have a product where people upload Swagger files), most people write it by hand. There's two reasons:
1) Many people use Swagger to design (rather than document), meaning the Swagger comes before the code
2) Most people just prefer to write it out, since the tooling otherwise isn't necessarily great (especially for non-developers)
We ran a poll and "by hand" (either on Swagger Hub/Apiary, or locally) won by a landslide.
- dwaltrip 10y agoHow does a non-developer know how to document or design an API?
- numbsafari 10y agoPerhaps the first pass of the doc is written by a developer but it is later updated by a tech-writer, or you need to produce a translated version.