Ask HN: What have you used to document your public API?

2 points by richardv 12y ago ↗ HN

Self-explanatory.

What tools/resources/docgens/services have you used to provide documentation for your public facing API services that you are providing to customers.

2 comments

[ 4.3 ms ] story [ 70.0 ms ] thread

angersock 12y ago ↗

We use a wiki (Dokuwiki) for internal docs, probably going to either make it public or perhaps switch over to Daux.io once I'm satisfied it doesn't hate America.

johns 12y ago ↗

I prefer hand-written. But other people like Swagger https://developers.helloreverb.com/swagger/, I/O Docs https://github.com/mashery/iodocs, Daux (although this is just a style framework) http://daux.io/ and http://apiary.io/