Forum Moderators: coopster
PHP Manual Updates[03-Feb-2007] The PHP documentation team is proud to present to the PHP community a few fixes and tweaks to the PHP Manual [php.net], including:
- an improved, XSL-based build system that will deliver compiled manuals to mirrors in a more timely manner (goodbye dsssl)
- manual pages can now contain images (see
imagearc()[php.net] for an example)- updated function version information and capture system (fewer "no version information, might be only in CVS" messages)
- ... and more to come!
Please help us improve the documentation [php.net] by submitting bug reports [bugs.php.net], and adding notes to undocumented functions.
I like the idea that the manual now contains images. No, you won't be able to submit your own images in the User Contributed Notes area. Not yet at least. I can only imagine the can of worms that might open. However, to be able to see a visual from the developers is going to be a nice addition.
I like the idea that the manual now contains images.
Me too! I'm not sure whether it is good or bad for someone learning that needs to do something in order to understand it. I know when I first started to learn php I didn't know anything; I HAD to copy the code, run it on my server, and play around with it. At the time I had no idea what the code actually did so it the curiosity that made me play with it a little.
I think that if images of the code's output are shown, it will destroy that curiosity that makes people(well, at least me;)) play around with the code--which ultimately allows them to learn for themselves.
It is, however, a nice addition to those of us who are knowledgeable in PHP and want to do a "quick read" of the code for one reason or another.
I don't really know if my point is valid or not, but...I don't know....hehe
We'll see how it helps the new and the experienced, now won't we.
P.S. This does not mean I don't like the idea of having images; just saying that for you newbies wanting to learn PHP, make sure that you copy the code and play around with it; it's the only way you are going to learn! :)
P.P.S Well...ok...it's not just for newbies; everyone should learn by trial and error (unless we are talking about skydiving!)
