News for hackers. Stuff that matters.
Re:Scripted.com API: Interactive Documentation by johns on Wednesday May 09, 2012 @07:20PM (#3951010)
This is a nice take on the I/O Docs/API Explorer style (e.g. http://developer.mashery.com/iodocs). Those sample JSON responses could really stand to get some pretty printing though. Don't provide example responses if they're unreadable. The post even touches on this ("An API’s documentation is its human interface") so it would nice to see them made more human-readable.
Re:Scripted.com API: Interactive Documentation by jbkring on Wednesday May 09, 2012 @08:21PM (#3951209)
Yup, agree wholeheartedly! Will work on that shortly.
Re:Scripted.com API: Interactive Documentation by rbucks on Wednesday May 09, 2012 @07:31PM (#3951055)
With the Scripted API, you can build a self-publishing website in < 50 lines of code. We're publishing to our own magazine sites using this API!

Basic flow:

Use a feed to parse and generate topics Push blog article jobs to Scripted Pull finished content from Scripted Post content to your CMS

We'll write another blog post about it in a couple of weeks.

Re:Scripted.com API: Interactive Documentation by pjscott on Wednesday May 09, 2012 @08:01PM (#3951142)
The Redis docs are similar, albeit not quite as fancy. The reference page for each command includes a few example requests and their results -- and it's connected to a running Redis server, so you can actually type commands into it. Check it out:

http://redis.io/commands/sadd

Re:Scripted.com API: Interactive Documentation by smanek on Saturday May 12, 2012 @08:53AM (#3963699)
Woah - I've used those docs dozens of times and never realized that the demos were interactive. I just assumed they were static examples. Thanks!
Re:Scripted.com API: Interactive Documentation by jbkring on Wednesday May 09, 2012 @08:20PM (#3951207)
Love the redis docs! Redis powers the background queue at Scripted.
Re:Scripted.com API: Interactive Documentation by rbucks on Thursday May 10, 2012 @12:29AM (#3951858)
There should be a rule that if you have to write a wrapper for the API, then it's either poorly designed or poorly document, or both. Eg PayPal, Google, LinkedIn.
Re:Scripted.com API: Interactive Documentation by rausanka on Wednesday May 09, 2012 @06:42PM (#3950867)
Some of the most beautifully formatted API docs I've ever seen. It's really nice to have design care applied to developer pages.
Re:Scripted.com API: Interactive Documentation by cpdean on Wednesday May 09, 2012 @06:49PM (#3950896)
i love the recent upgrade to git-scm http://git-scm.com/docs/git-rebase
Re:Scripted.com API: Interactive Documentation by jbkring on Wednesday May 09, 2012 @06:50PM (#3950902)
thanks! but i have to give credit where credit is due: bootstrap.
Re:Scripted.com API: Interactive Documentation by Matt_Mickiewicz on Wednesday May 09, 2012 @07:02PM (#3950951)
I'm really excited to see what will be done with this.
Re:Scripted.com API: Interactive Documentation by amantesting on Wednesday May 09, 2012 @08:27PM (#3951234)
This looks very usable. Getting started tonight.
Re:Scripted.com API: Interactive Documentation by irinai on Wednesday May 09, 2012 @06:40PM (#3950855)
This will be great for small businesses!
Re:Scripted.com API: Interactive Documentation by rupatejura on Wednesday May 09, 2012 @07:44PM (#3951105)
Excellently scripted API doc.