4 ms·
Is is just me, or are their docs kind of yuck/hard to read? http://docs.timdorr.apiary.io/#vehiclecommands http://docs.timdorr.apiary.io/#vehiclecommands My b
by killahpriest 13y ago
Is is just me, or are their docs kind of yuck/hard to read?
http://docs.timdorr.apiary.io/#vehiclecommands http://docs.timdorr.apiary.io/#vehiclecommands
My biggest problem: way too much visual emphasis on 'GET' part and not enough on the actual URL. That has way more priority, to me.
- tieTYT 13y agoI like the swagger layout. http://swagger.wordnik.com/#!/pet http://swagger.wordnik.com/#!/pet Their developer documentation is kind of tricky to figure out though.
- StavrosK 13y agoI liked swagger a lot, but could never get it working with my API because it's too opinionated. From the little I tried to do, there was no way at all to tell it to document the API the way I had designed it, rather than the way it thought APIs should be designed.
- joshguthrie 13y agoNice layout. Reminds me of IO/Docs which I use actively for my own application. I like the ability to "try it yourself" though a mix of it with "here is the default response if it works, here is the response if it fails" is better for POST/PUT/DELETE routes.
- jonahx 13y agoI think they look great. I could imagine having a few nitpicks, but never describing them as "yuck"
- deleted 13y ago[deleted]
- ktsmith 13y agoI actually agree and find them very unappealing. They seem too dense and the text either too light, too small, or both.