Re: PEAR Snippets
| From: | Tony Bibbs | Date: | Thu, 06 Feb 2003 22:34:33 +0000 |
| Subject: | Re: PEAR Snippets | ||
| References: | 1 | Groups: | php.pear.dev |
| Request: | Send a blank email to pear-dev+get-13035@lists.php.net to get a copy of this message | ||
Well, not to labor all PEAR developers too much, and maybe this has
already been discussed, but I find PHPDoc notes more than sufficient for
90% of what I do. I know PEAR coding standards require PHPDoc comments,
but what about actual documentation generation? IMHO, I think when
browsing package where you see the links for "download latest",
"changlog", "view source code in CVS", etc there should be a link to the
PHPDoc documentation set.
--Tony
On Fri, 7 Feb 2003, Yavor Shahpasov wrote:
> Hello ,
>
> I was thinking today about snippets rpository for pear. We could have
> snippets or code samples for pear classes. Since finding uptodate
> documentation of most classes (no disrespect the PEAR doc has gone a long
> way, and am really happy it's there) is hard, I was thinking about a user
> contribution system where people could submit samples of how to do things
> with pear classes might be a good idea. Snippets could use the current
> package structure so there would be no need for categories.
>
> this would be a gret plus for newbies which are new to pear.
>
> If this idea gets accepted an willing to start implemnting it.
>
> It would require a new DB table and am thinking to submit a snippet a user
> would have to have a pear account to avoid moderation.
>
> More after feedback :)
>
> + or - what will it be
>
> Yavor
> **** http://www.netsmartlogos.com ****
> Latest Logos, ringtones, call now and win!!
> **Powered by NetSmart.Com.Cy**
>
>
>
--
------------------------------------------------------------------------|
Tony Bibbs | "I guess you have to remember that those who don't |
tony@tonybibbs.com | hunt or fish often see those of us who do as |
| harmlessly strange and sort of amusing. When you |
| think about it, that might be a fair assessment." |
| --Unknown |
------------------------------------------------------------------------|