News Feed
Jobs Feed
Sections




News Archive
Looking for more information on how to do PHP the right way? Check out PHP: The Right Way

Jason Lefkowitz's Blog:
The Worst Thing About PHP
June 01, 2006 @ 14:45:05

In his latest post, Jason Lefkowitz takes on something that's praised by PHP developers and non-PHP developers alike - the documentation for the project. There's just something he finds messy about the whole business.

Really, it has more to do with the way that PHP's structured than the actual documentation. It's just a case of art imitating life.

Now, having lots of libraries isn't necessarily bad - Java has an even more Herculean list. It only becomes a problem when you make no distinctions between them in the docs - like PHP.

PHP just throws a huge list of libraries at you and leaves you to figure out which one you need. There's no overarching "Database" package - instead you get Postgres functions and Oracle functions and Firebird functions and MySQL functions, all sprinkled throughout the list.

He also comments that the entire listing is also cluttered with other functionality, things that most developers would toss aside if they came across - they just don't need them.

His point isn't without merit - there is definitely a need to reorganize things in the manual to make them a bit more "topic friendly". The documentation is already one of the most well-maintained in the Open Source community, so the content is there, maybe it's just the structure that needs to be changed.

0 comments voice your opinion now!
worst thing documentation organized function worst thing documentation organized function


blog comments powered by Disqus

Similar Posts

Community News: Zipline Interactive's PHP Function Finder Widget

PHP.net: PHP Documentation Update

Fabian Schmengler's Blog: Anonymous function calls in PHP

Alexey Zakhlestin's Blog: Ode to mb_ereg functions

Sara Golemon\'s Blog: libssh2 API documentation - Complete


Community Events











Don't see your event here?
Let us know!


security language release project install application symfony2 package podcast component introduction performance facebook hack unittest composer example database framework hhvm

All content copyright, 2014 PHPDeveloper.org :: info@phpdeveloper.org - Powered by the Solar PHP Framework