On Thu, Jun 26, 2008 at 1:42 PM, Gustavo Carreno <[EMAIL PROTECTED]> wrote:
> Now, with the time you took to cry about your issue and even write
> this, quite large, email I supose you could do something better with
> that time:
> - Register an account at book.cakephp.org
> - Browse through the contents and find where your knowledge would be
> well aplyed.
> - Enter the suggested text to be approved
> - After a while, rejoice because your contribution was accepted
> - Keep the warm feeling that ALOT of newbies will read your input for
> a long time to go. Futile messages about the Docs are just to much
> passé !!

Gustavo,

Thank you for showing the proper way to respond to criticisms about
the CakePHP documentation.

Wayne, while you are being singled out in this thread, I think people
are not alone in feeling overwhelmed by how to build something with
CakePHP.  If you don't have time to do the research (despite your
fantasticaly long email showing that you do indeed know how to find
answers) then I really think that CakePHP will disappoint you because,
well, you really need to be able to find out your own answers to
questions.  Documentation is hard and nobody (/me waves to psychic)
really wants to do it.  Is it any wonder that those amongst us who
have contributed documentation get upset when people complain about
it?

People have to understand that there comes a point whether you want to
be a developer, creating things and really understanding what you are
using, or a typist, relying on copious examples that you can simple
take and cut-and-paste into your work and then go onto the next
solution.  I believe that CakePHP wants you to be a *developer*, not a
*typist*.

So, to get back to my original point:  there is nothing stopping any
one from contributing documentation to the CakePHP manual except
themselves.  If you choose to direct your energies into complaining
about the documentation, that is obviously your choice.  Just don't be
shocked when people disagree with your tactics and suggest other
things.

-- 
Chris Hartjes
Internet Loudmouth
Motto for 2008: "Moving from herding elephants to handling snakes..."
@TheKeyBoard: http://www.littlehart.net/atthekeyboard

--~--~---------~--~----~------------~-------~--~----~
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