Re: User commentary in docs

On Tue, 6 Apr 2010, Rasmus Lerdorf wrote: > Robert, you could pitch in and help clean up and incorporate the > comments then. I am sure Dan and the others would appreciate the > help. > There is simply too much user feedback and too few volunteers to get > them all into the documentation in a timely manner. We found long > ago that the best alternative was to have a quick way to get rid of > bad comments and let the majority of stuff through because there > really is some good contents in there. > You may not like them, but I can tell you that the huge majority of > feedback we get on them is positive. Almost everywhere I go, no > matter where it is in the world, the user comments in the > documentation is something people say they love about PHP. sorry, that last post of mine came across as unnecessarily harsh, and i apologize. sure, after i dig out from under my current project, i can probably help out. and, yes, there are the occasional gems of advice, no doubt about it. but you do appreciate my original observation regarding pages like this: http://www.php.net/manual/en/language.variables.php the fact that readers *can* comment should not suggest that they *must* comment. and, more importantly, they should try to comment on the appropriate page so that their comment makes sense. rday -- ======================================================================== Robert P. J. Day Waterloo, Ontario, CANADA Linux Consulting, Training and Kernel Pedantry. Web page: http://crashcourse.ca Twitter: http://twitter.com/rpjday ========================================================================