Re: Documentation..

From: Date: Mon, 06 Dec 2004 22:15:57 +0000
Subject: Re: Documentation..
References: 1 2 3 4 5 6 7 8 9 10 11  Groups: php.pear.qa php.pear.qa 
Request: Send a blank email to pear-qa+get-2093@lists.php.net to get a copy of this message
Justin Patrin wrote:
On Mon, 6 Dec 2004 22:25:42 +0200, anatoly techtonik <techtonik@php.net> wrote:
Hello Lukas,
However - it would probably also be a good idea to make a user submitted examples section or something like that for the most lazy developers..
I will second this suggestion, because I knew this from Agilent VEE, where user contributed examples where shipped out with the full version.
LS> why not just open a feature request with a link to the source ... i LS> doubt any developer wouldnt be happy to add the example to the distro LS> after a quick look over the source. Because it is not a feature request and dumb users like me are either too lazy to contribute to stale closed community or don't have a proper amount of imagination to draw association between Feature Request and Example. It can be my only IMHO, but (RFE != Example for existing feature).
Stale? Closed? Are you trying to be a troll?
He's not trolling. Anyone "outside" PEAR knows exactly what he means; hell, some of us "inside" PEAR know what he means. When you get "if you want docs then you write them, this is open source" it's not exactly a friendly invitation to join the party. I'm not criticising anyone, just informing. ;-)
PHPDOC already has the solution. It is user notes.
It has been implemented for pearweb, but not put into production yet.
In addition, Arnaud and I are working on a YaWiki implementation for PEAR; I just uploaded the first attempt at a proper theme to match pearweb, and it appears to be working mostly OK. With any luck we'll have a first version ready before he leaves on vacation. -- pmj

« previous php.pear.qa (#2093) next »