Re: [Pharo-project] Ideas for HelpSystem

2010-12-12 Thread Stéphane Ducasse
let us start small but steady instead of having the full system only in dream. We should really improve on that level so I will allocate some time on that and integrate less fixes. Stef On Dec 12, 2010, at 6:04 AM, Damien Pollet wrote: On Sat, Dec 11, 2010 at 00:18, Bernardo Ezequiel

Re: [Pharo-project] Ideas for HelpSystem

2010-12-11 Thread Sven Van Caekenberghe
On 11 Dec 2010, at 00:18, Bernardo Ezequiel Contreras wrote: here's a similar example http://soek.goodies.st.s3.amazonaws.com/index.html Very nice indeed. Never heard of the Cloudfork project, I am reading now... Sven

Re: [Pharo-project] Ideas for HelpSystem

2010-12-11 Thread Sean P. DeNigris
Damien Pollet wrote: The Ruby guys have a really nifty tool for code documentation Since we're pushing for total documentation, tools are very important because they create a feedback loop on documentation quantity and quality - if one knows docs will be read, one will be more likely to

Re: [Pharo-project] Ideas for HelpSystem

2010-12-11 Thread Damien Pollet
On Fri, Dec 10, 2010 at 18:41, Stéphane Ducasse stephane.duca...@inria.fr wrote: what do you mean by it can run as a web server? you have a system and a server and the docs are generated on the fly? yard server --gems launches a webserver (typically webrick, but there are options to run thin or

Re: [Pharo-project] Ideas for HelpSystem

2010-12-11 Thread Damien Pollet
On Sat, Dec 11, 2010 at 00:18, Bernardo Ezequiel Contreras vonbecm...@gmail.com wrote: here's a similar example http://soek.goodies.st.s3.amazonaws.com/index.html Indeed, but part of my point was the how polished Yard is (both appearance and interaction). It integrates API and

[Pharo-project] Ideas for HelpSystem

2010-12-10 Thread Damien Pollet
Hi all, The Ruby guys have a really nifty tool for code documentation (mainly per-class, per-method etc, but README files are used as well and can serve for tutorials). It's called Yard: http://yardoc.org/ Typically it's used to generate documentation, like javadoc, but it can run as a web

Re: [Pharo-project] Ideas for HelpSystem

2010-12-10 Thread Stéphane Ducasse
On Dec 10, 2010, at 5:17 PM, Damien Pollet wrote: Hi all, The Ruby guys have a really nifty tool for code documentation (mainly per-class, per-method etc, but README files are used as well and can serve for tutorials). It's called Yard: http://yardoc.org/ Typically it's used to generate

Re: [Pharo-project] Ideas for HelpSystem

2010-12-10 Thread Stéphane Ducasse
I would really to have that for pharo. Anybody looking for a small project with a big impact on the community? On Dec 10, 2010, at 5:17 PM, Damien Pollet wrote: Hi all, The Ruby guys have a really nifty tool for code documentation (mainly per-class, per-method etc, but README files are

Re: [Pharo-project] Ideas for HelpSystem

2010-12-10 Thread laurent laffont
A year ago I've done this to learn http://magaloma.seasidehosting.st/ (newbie) code is here http://www.squeaksource.com/SimpleWebDoc.html I won't touch it because I work on other stuff but feel free to try and ask. Laurent On Fri, Dec 10, 2010 at 6:42 PM, Stéphane Ducasse

Re: [Pharo-project] Ideas for HelpSystem

2010-12-10 Thread Stéphane Ducasse
thanks for the pointer On Dec 10, 2010, at 7:40 PM, laurent laffont wrote: A year ago I've done this to learn http://magaloma.seasidehosting.st/ (newbie) code is here http://www.squeaksource.com/SimpleWebDoc.html I won't touch it because I work on other stuff but feel free to try and

Re: [Pharo-project] Ideas for HelpSystem

2010-12-10 Thread Bernardo Ezequiel Contreras
here's a similar example http://soek.goodies.st.s3.amazonaws.com/index.html