News for hackers. Stuff that matters.

A comment on Problems with Swagger. Parent comment

Re:Problems with Swagger by gkoberger on Tuesday April 04, 2017 @05:10PM (#14037238)
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.

[ Parent | on HN ]
Re:Problems with Swagger by dwaltrip on Tuesday April 04, 2017 @10:55PM (#14039298)
How does a non-developer know how to document or design an API?
[ Parent | on HN ]
Re:Problems with Swagger by numbsafari on Tuesday April 04, 2017 @11:31PM (#14039459)
Perhaps 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.
[ Parent | on HN ]