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

2 pointsrichardv2 comments

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.

View on HN

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/

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.

Reply on news.ycombinator.com