Re: [web2py] How to write documentation for REST API?

2015-09-16 Thread Richard Vézina
Consider using other theme, I like abalaster (I think it the one used by Flask, minimalist) : https://pypi.python.org/pypi/alabaster I didn't see it but there is a bootstrap one too : https://pypi.python.org/pypi/sphinx-bootstrap-theme/ Your project look nice... A lot of work... :) Richard On

Re: [web2py] How to write documentation for REST API?

2015-09-15 Thread Michele Comitini
In the end I used sphinx with this extension: http://pythonhosted.org/sphinxcontrib-httpdomain 2015-09-15 3:56 GMT+02:00 Richard Vézina : > I like the way it's done here : https://open.fda.gov/api/reference > > I had saw many API doc that were looking the same (just can found back a > couple o

Re: [web2py] How to write documentation for REST API?

2015-09-14 Thread Richard Vézina
I like the way it's done here : https://open.fda.gov/api/reference I had saw many API doc that were looking the same (just can found back a couple of example). I thought at first that it was made using sphinx but can't found any trace of it in the souce of the page or on the github of the open fda

[web2py] How to write documentation for REST API?

2015-09-14 Thread Michele Comitini
What is a good way to document a small REST API (@request.restful)? sphinx? Suggestions welcome! mic -- Resources: - http://web2py.com - http://web2py.com/book (Documentation) - http://github.com/web2py/web2py (Source code) - https://code.google.com/p/web2py/issues/list (Report Issues) --- You