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

Reply via email to