Hacker News new | past | comments | ask | show | jobs | submit login

This is interesting, do you have an example repository with that setup? My team currently uses Swagger for documentation which provides decent documentation for us, so what sort of documentation at the repository level could I gain by using this setup instead or in combination? Also, how would one detect that the documentation has been correctly updated aside from manual inference?



Swagger is not documentation, it is is a way to generate executable API examples from code comments.




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

Search: