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

Hasin Hayder's Blog: Counting occurrence of a word in a String - Benchmarking of PHP functions

Antony Dovgal's Blog: PhD docu builds are online!

Nexen.net: PHP month of functions

Jonathan Snook's Blog: CakePHP: Initial Thoughts

Ben Ramsey: Introducing Array_column() in PHP 5.5


Community Events





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


list release laravel interview introduction unittest install code framework series developer symfony2 opinion refactor language community podcast experience threedevsandamaybe testing

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