Sign Up to our social questions and Answers Engine to ask questions, answer people’s questions, and connect with other people.
Login to our social questions & Answers Engine to ask questions answer people’s questions & connect with other people.
Lost your password? Please enter your email address. You will receive a link and will create a new password via email.
Please briefly explain why you feel this question should be reported.
Please briefly explain why you feel this answer should be reported.
Please briefly explain why you feel this user should be reported.
I’m trying to use auto-doc tool to generate API doc for Tastypie REST API. I tried Tastytool, but it seems not showing the API’s result parameters but the model’s columns. Then I tried Sphinx seems more promising since Tastypie supports Sphinx, but I can’t find an example to show where & how to put comment for the API inside the code, and generate them into the document.
Anyone can share some info or example about correctly write comment and generate Sphinx doc for Tastypie based API? thanks.
You might want to take a look at tastypie-swagger, which uses Swagger to generate a /doc/ page for your Tastypie API.
I’ve had some success with it, after a few minor adaptations (which were necessary due to a tastypie version difference, I suppose).
Edit: The adaptations I found necessary (due to a django version < 1.4 and tastypie version > 0.9.11) are now merged into the mainline branch of tastypie-swagger.