Nevertheless, it's not going to happen until people commit to making
it so. What do you need from me to help make this a reality?
--
Rocco Caputo - [EMAIL PROTECTED]
On Sep 7, 2007, at 22:12, lanas wrote:
Le Vendredi, 7 Septembre 2007 15:29:52 -0400,
Rocco Caputo <[EMAIL PROTECTED]> a écrit :
POE has had a "documentation" project for over four years. It's in
http://poe.svn.sourceforge.net/viewvc/poe/trunk/docs/ ... see
revision 1997 for some really old documentation.
If people are really interested in contributing, please let me know
how I can help. I can't actually write documentation. Until POE's
perldocs are done, they have priority on my documentation
resources. Maybe I can resurrect some old guidelines and outlines to
provide some guidance, though.
Personally, how I see it is more like a real book than documentation.
For comparison's sake, it'd be like a book on Perl OO such has the one
by Damian instead of the Perl OO man pages. The POE Cookbook gives
some
good examples, but it is not like a book with all the extraneous text
and context explanation unecessary bla bla and such things (even
funny bits) that makes a book a book. That makes it an interesting
read and ultimately inspiring for trying things out.
Documentation is very important, but a book, with its less formal
approach is great when it uses entertaining and interesting examples,
not only the basic stuff.
Cheers,
Al
