Hacker Newsnew | past | comments | ask | show | jobs | submitlogin

Do the inline documentation with the apiDoc format[1]. Readme.io has also created and documented a superset of apiDoc that you might want to look into. Obviously their tool supports it, but it seems easy to roll your own frontend for the API data once you extract it from your code.

1. http://apidocjs.com/



Thanks for the rec! I'm obviously super biased (ReadMe founder, here), but ReadMe was built for this kind of scenario, spot on. apiDoc is good for keeping the endpoint docs up to date, and you can keep it internal with a password or admin-only access. Search should be improving later this month.


ReadMe is the one that looks very promising. But somewhere on HN, someone from your team commented that internal use is frowned upon and the system gets more and more naggy if used internal only. Is that still true? If yes, does that stop after we start paying?




Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: