News 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

Philip Olson's Blog: Learning how to help people contribute to the PHP.net Project

Larry Garfield's Blog: Benchmarking magic

Community News: XPath Explained (by Tobias Schlitt and Jacob Westhoff)

Phil Thompson's Blog: 7 PHP functions that saved my life

DevShed: Creating an Administration Area for a Simple Threaded Discussion Forum


Community Events

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


psr7 introduction library laravel extension podcast release wordpress unittest series language community api conference interview framework opinion laravel5 development voicesoftheelephpant

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