[web2py] proposal for online documentation

2010-02-05 Thread mdipierro
I got a private email from David and we have an idea: 1) organize a wiki with the same table of content as the book. Each page will have an errata and a a faq. It will include some parts of the book (when possible) and link the scribd book chapters when not possible. 2) integrate the above with

Re: [web2py] proposal for online documentation

2010-02-05 Thread tiago almeida
Hi! 1) Great idea. 2) Wouldn't the docstrings get immensely complex for someone actually reading/mantaining the code? Maybe a Sphinx approach to code documentation would be better. Best regards, Tiago On Fri, Feb 5, 2010 at 4:11 PM, mdipierro mdipie...@cs.depaul.edu wrote: I got a private

Re: [web2py] proposal for online documentation

2010-02-05 Thread Jonathan Lundell
On Feb 5, 2010, at 8:11 AM, mdipierro wrote: I got a private email from David and we have an idea: 1) organize a wiki with the same table of content as the book. Each page will have an errata and a a faq. I'd been thinking of that myself (so it must be a good idea!). It will include some

Re: [web2py] proposal for online documentation

2010-02-05 Thread Zoom.Quiet
On Sat, Feb 6, 2010 at 00:26, tiago almeida tiago.b.alme...@gmail.com wrote: Hi! 1) Great idea. great +1 2) Wouldn't the docstrings get immensely complex for someone actually reading/mantaining the code? Maybe a Sphinx approach to code documentation would be better. when collection

Re: [web2py] proposal for online documentation

2010-02-05 Thread Jason Brower
I also agree, then we create a dynamic and growing collection of documentation and when I need the information from the book I can get it there as well. Very fun idea indeed. BR, J On Fri, 2010-02-05 at 08:11 -0800, mdipierro wrote: I got a private email from David and we have an idea: 1)