discuss: Should the PHP Howto remain in the LDP?
Subject:
Re: Should the PHP Howto remain in the LDP?
From:
Mark Komarinski ####@####.####
Date:
14 Mar 2002 16:01:16 -0000
Message-Id: <1016121637.10240.15.camel@jackie>
I took a look at the document and I found that there is a lot of
editorializing. I guess I (or the LAG) could be guilty of that as well,
but there's a difference between writing a sentence or two with opinion
and whole sections. Some of these opinions are based on wrong facts.
Example from http://www.linuxdoc.org/HOWTO/PHP-HOWTO-1.html
* PERL is "YUCKY" (distasteful) because it is hard to read and
maintain the programs. Not object oriented.
followed by
* Only PHP will prevail in the 21st and 22nd century!
I can write unreadable PHP code just like anyone else, but both PHP and
Perl have OO capabilities. And if my code is still around
100 years from now, well..uhm..yeah ;)
I'd recommend a tech review (I'll help) followed by a reorganization of
the entire document. Filtering out the editorializing may be a result,
but could erupt in a mini-flame-war if the reviewer and author disagree.
-Mark
On Thu, 2002-03-14 at 10:51, Joy Y Goodreau wrote:
> It seems reasonable that when a document is cause for concern that we
> schedule a review of that document. We are hoping to get to all documents
> on the site, eventually.
>
> I will be more than happy to do the language review. If someone who
> considers themselves as having technical expertise ( 1 or 2 people would be
> great) in this area could also volunteer to do a technical review of the
> document then we have something to work with. For the technical review we
> are looking for solid instances of inaccuracies or weakness in the
> explanation of the process of technology. These should be coupled with
> suggestions of how to fix the problem. Both will be presented to the
> author, based on his/her modifications to the document, we can then decide
> whether to remove the document or "suspend" it.
>
> Once a technical reviewer has stepped forward, I'll contact the author, and
> let him know the document is under review.
>
> If you have other suggestions for how to handle this, please let me know.
>
> Thank you,
>
> joy
>
>
> Joy Yokley Goodreau
> Linux Information Development
> IBM Linux Technology Services
> 512-838-4118
> ####@####.####
>
>
> _________________________
> http://list.linuxdoc.org/
>