Nate, as one of the dev leader, you should temper your language, I
find it harsh....

I don't see exactly where is the problem with that wiki. In fact, I've
made a wiki myself to help me think throught some process that weren't
correctly described here and there when the book was still just a
thought. I wish I could write something in the book, but I don't feel
my experience with Cake is anoff to write something tagged "official",
and probably many others out there.

Writing into a wiki or "the book" are two different tasks. One is
ludic, the effort for parcipating into the redaction can be seemless
and the other has an inbound "professionnal objective", it is "the"
book.

Wikis have became sandbox over the time and are excellent tools at it.
While the book is meant to be [someday] a finished documentation, the
implication needed to add something to it is 10 time superior to a
wiki. It's the same as a learning curve, wikis are now on the bottom
left of the "learning to write on the web" and that kind of book is on
the top right. Even experienced programmer need to get confidence
before writing somewhere else then into the DocBlocks.

Indeed, I like the idea of having a "practicing" wiki where the
documentation is built on a more collaborative way (transparacy,
revision/correction, etc. ok, someday, the book shall be too, but
mediawiki is mature on these right now) then maybe propose that
material to the official doc portal. Hey, the guy even called it
"unauthorized" and putted a link to the official doc, I can't see any
bad intention there!


To get back to the main title...
Maybe you should be more specific about the different types of
documentation distribution possible (don't know if there is some
licence for that, no specialist here), something for online
distribution, printed distrib (free or $), etc. Distribution of the
book with other APIs/docs to a team can happen more frequently while
cake gets used by more and more professionnal. A case by case analysis
isn't really effective in these situation (what is effectiveness you'd
ask ).

David
--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups 
"CakePHP" group.
To post to this group, send email to [email protected]
To unsubscribe from this group, send email to [EMAIL PROTECTED]
For more options, visit this group at 
http://groups.google.com/group/cake-php?hl=en
-~----------~----~----~----~------~----~------~--~---

Reply via email to