Ask HN: What have you used to document your public API?
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.
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.
Comments
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.