[tg-trunk] Re: Task based documentation

2006-05-02 Thread Alberto Valverde
On 02/05/2006, at 14:08, Michele Cella wrote: Hi guys, I would like to hear your opionion regarding how our docs are actually organized, personally I find the *big* index of content too much book oriented, it doesn't fit so well inside the web and it's quite intimadatory for the newbie,

[tg-trunk] Re: Task based documentation

2006-05-02 Thread Michele Cella
Alberto Valverde wrote: +1, though reference style docs are also helpful... maybe these could be placed in docstrings and link to the pydoc generated pages from the tasks? Yeah, indeed reference are essential but ATM we have a mix of the two things, and since we are under-documented the

[tg-trunk] Re: Task based documentation

2006-05-02 Thread Jorge Godoy
Em Terça 02 Maio 2006 09:08, Michele Cella escreveu: I would like to hear your opionion regarding how our docs are actually organized, personally I find the *big* index of content too much book oriented, it doesn't fit so well inside the web and it's quite intimadatory for the newbie, that