News Feed
Sections




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

Adam Harvey's Blog:
(Unmoderated) manual notes are bad, mmkay?
October 30, 2009 @ 10:49:16

In this new post to his blog Adam Harvey shares his opinion on unmoderated notes dropped directly into the PHP manual - "they're bad, mkay?"

I've had a couple of whinges on IRC lately about why I'm not thrilled with having user notes in their current form in the PHP manual; we get entirely too many questions in ##php from people who've copied code out of a note and are then annoyed when it turns out the code is wrong, broken, horrible, or all of the above.

His gives an example (one of many currently in the manual) that shows a round-about way of getting a date string that could be done better in a single "format()" function call on a DateTime object.

I don't know what the answer is - moderation has its own problems to do with workload, as PEAR can attest - but a system that's letting that go up as recommended practice (and stay up for a month) has to be looked at.
0 comments voice your opinion now!
manual notes bad opinion moderate


blog comments powered by Disqus

Similar Posts

Volker Dusch's Blog: How i judge frameworks - Or: Let me code in peace

Alexei Shuga's Blog: On passing Zend PHP 5.3 exam

Chris Roane's Blog: PHP Programming: The Benefits of Peer Pressure

PHPClasses.org: Accelerate Web Pages Automatically using Google Mod_PageSpeed

Alison Holloway's Blog: PHP 5.2.2 Setup on Windows


Community Events





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


api framework install library series package release language bugfix list community interview opinion laravel symfony deployment voicesoftheelephpant tips podcast introduction

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