Re: Fix this FAQ ! (was: [PEAR-BUG] Bug #923)

<bmansion@mamasam.com> wrote : > <pear-dev@lists.php.net> wrote : > >> ATTENTION! Do NOT reply to this email! >> To reply, use the web interface found at >> http://pear.php.net/bugs/bug.php?id=923&edit=2 >> >> >> ID: 923 >> Updated by: richy@php.net >> Reported By: bmansion at mamasam dot com >> Status: Open >> Bug Type: Mail_IMAP >> PHP Version: Irrelevant >> New Comment: >> >> Honestly I don't *have* to do anything, as far as I'm conserned I've >> done exactly what has been specified in the F.A.Q. page that I already >> pointed out. >> >> If this is the way that the PEAR Group wants it done, then the >> package.xml F.A.Q. page should reflect that. >> >> Two you *not caring* whether the user knows where your examples are or >> not seems to defeat the purpose of contributing code in the first >> place. I want my package to be both understood and used. >> >> Its confusing, the documentation doesn't say to do it that way and >> there's nothing in the docs that says that I can't have it that way, in >> fact quite the opposite it lays out that I've already got it right. >> And quite frankly I don't see what it is hurting. Before we continue >> this discussion you should have a look at the F.A.Q.. regardless of if >> yours or other packages are doing it differently. To me a role="doc" >> implies the complete offical documentation including highlighted source >> code, method explaination, etc.... these are PHP source files, >> therefore they should be labled role="php". >> >> My being new to PEAR, it would be quite helpful if all the little >> pet-peaves and unspoken standards were all laid out flatly and plainly >> in the official documentation. And yes, in plain enough terms that an >> idiot could understand. Because it isn't always that obvious. Oh yes, and BTW we wouldn't have wasted so much bandwidth and time (3 releases just to fix wrong install paths...) if you had listened to me in the first place when I said, "look at other package.xml files", use role="doc". I guess you didn't even try. Being deaf to recommendations from people who have been working on PEAR for many years to try to make it consistent won't help. Bertrand Mansion Mamasam