8 reasons why you should *not* write for the php.net manual

8 reasons why you should *not* write for the php.net manual:

  • You get more page hits by publishing your work on your blog
  • You get a free pass to conferences by converting your work into presentation
  • You get paid to submit your work to magazines & commercial websites
  • You get a "trading card" and considered a star
  • The community will know your name
  • You can flame the documentations without needing to do anything about it
  • You can copy&paste parts from the manual and sell it (see point#3)
  • You can license your work to forbid any commercial use or further improvements

:)

Comments

  1. AnonymousOctober 14, 2007 at 1:10 PM

    I like to the getting paid part...

    ReplyDelete
  2. AnonymousOctober 14, 2007 at 3:06 PM

    I'm glad that most people who DO write for the PHP Manual don't think like you.

    If they did, there would be no manual and, with no manual, there would be no PHP as we know it.

    Were you not a main contributor to the manual, I would find this post rather insulting to the other developers who contribute their time and effort to the PHP documentation.

    Rant over. Keep up the good work. :-)

    ReplyDelete
  3. AlexOctober 14, 2007 at 11:51 PM

    Nice ;-)

    Manual, per se, is complete when it is nothing to remove from it, not when everything possible added.

    I strongly believe that manual should contain the best articles, when most of the PHP-related information just is not in proper format (tutorials, short reviews, etc).

    ReplyDelete
  4. bjoriOctober 15, 2007 at 4:29 AM

    PHP Manual Reader: Thats kinda my point.
    More and more people are thinking about themselves and publish their work on their blog or sell it.
    There isn't anything wrong with that, but its very annoying that user need to search for information on blogs, commercial websites or magazines rather than the manual.

    The PHP manual is getting more and more out of date, missing _alot_ of information about new features in PHP, where as if you search for (for instance) "namespaces php" you'll find lot of information on how namespaces work in PHP - but the manual doesn't say a word on namespaces.

    The manual has nothing to say on running PHP4, PHP5 and PHP6 all on the same server, but alot of people have blogged about it.

    These are only two examples that really really should be documented in the official PHP manual.

    ReplyDelete
  5. bjoriOctober 15, 2007 at 4:33 AM

    Alex: I agree, the PHP manual should contain articles, basic "how to use this extension", and quick "tutorials" on using the more "advanced" features of PHP.

    In the next weeks the PHP manual will be restructured making more room for articles/howtos/tutorial/advanced examples/...
    These changes scream out for new content and more people to participate in the documentation effort.

    :)

    ReplyDelete
  6. AnonymousOctober 16, 2007 at 8:20 AM

    Irony is lost on some people.

    ReplyDelete
  7. AnonymousJune 24, 2008 at 6:59 PM

    hi mentor !

    just want my own trading card :D

    ReplyDelete
  8. UnknownJanuary 5, 2010 at 8:01 AM

    they should implement some sort of rating system on users/comments and segregate the highest rated for the man pages, and put all the other crap into tips, examples, and crap that you need to go out of your way to see.

    ReplyDelete

Post a Comment

Popular posts from this blog

Unix manual pages for PHP functions

Did you know that unix manual pages for PHP functions and methods existed? For a while I had vim configured to run reflection when I hit " K ", but after the PHP documentation team released unix manual pages for PHP I now get the manual page in all its glory; function description, parameter descriptions, return values, examples, notes, see also and everything you are used to see from the online manual. Its awesome. As many PHP functions use "standard names" the documentation team decided to not install the manual in the standard man directory. When you install the unix manual package you get a little shell script (called "pman") which runs the normal "man" command for you, and sets the manual directory to wherever you installed the package. To install the PHP manual as unix manual pages: $ pear install doc.php.net/pman If you are running very old pear version you need to "discover" the doc.php.net channel first: $ pear c
Read more

up2date PHP5.3 packages for Ubuntu

Most Linux distributions have a policy of not being to up to date with upstream releases of software, mostly for good reasons. This however is extremely painful for developers, as it means they often need to use really outdated version, containing all sorts of bugs - and even missing features. This has been pissing me off for quite some time, so I have been running my own PHP builds for a while - but when it comes to deploying the apps... the sysadmins obviously start complaining that they have to invest a lot more work into maintaining the servers then they otherwise would have to. So.. What can we do about that?  Launchpad to the rescue! Launchpad makes it really easy to provide your own custom packages, and even has a vast build farm to build packages automatically for different architectures and different Ubuntu releases. The only down side is it doesn't build rpm packages.. Thats fine by me, but that would be really useful for those wishing to deploy on a RedHat based di
Read more

Next Generation MongoDB Driver for PHP!

For the past few months I've been working on a "next-gen" MongoDB driver for PHP -- codename " phongo ". The aim was to build a new PHP extension ontop of the mongoc and libbson libraries to reduce maintenance of the extension itself and focus more on providing the ecosystem with improved support and libraries. The new driver is available on PECL (called "mongodb", surprisingly enough) . It doesn't include any of the bells and whistles found in the previous "mongo" driver. It doesn't include any `group` or `count` command helpers, and you won't find any Collection or Database objects; however, it really doesn't need any of these things. All it has is simplicity. You can execute a command of your choosing. You can execute a query . You can execute a write . That's really it (as with everything, there are certain exceptions). Oh, it is also very, very fast. What's the Point? Most developers interact with datab
Read more