On Jun 4, 2007, at 2:48 PM, Joshua Benner wrote:

>
> John,
>
> Yes, I agree. It's not that I feel I'm not allowed to help -- but I'll
> admit I don't yet feel authoritative enough to produce solid
> documentation. Since I don't know CakePHP from beginning to end yet, I
> feel that a solution I may propose may be otherwise better  
> accomplished
> with a feature or capability I'm not familiar with yet, etc.
>
> All that to say... I'll probably be contributing somehow. Even if it's
> just as blog entries or something.

Who says you actually have to come up with the solutions to the  
problems?

If you can just give some *specific* direction on where things are  
lacking, that's enough. Log a ticket.

---

***Good examples:

I can't seem to find a good example in the manual of how to use  
generateList(). Some examples showing details on the parameters to be  
passed, and example output would be very helpful. The link to the  
page in the manual where this should go is...

You might want to mention the fact that the HtmlHelper might not be  
available when $helpers is specified manually. I might place that  
reference at ...

***Bad examples:

I can't find any tutorials on authentication.

The documentation for CakePHP is lacking.

OMG, How do I make a forum in CakePHP? kthxbye!!!!1

---

Besides: chances are you aren't going to wait for a documentation  
ticket to be resolved before you get your question answered. Chances  
are you'll figure it out - at which point you are perfectly  
positioned to make a contribution. However noobish or unpolished you  
think your code is, please just supply some basic documentation so I  
have something to work with. It's better than nothing. I'll take  
super newbie documentation contributions over what I [don't] get  
right now.

Note: please also realize that I may push back on your ticket. The  
CakePHP manual isn't meant to cover security practices, web server  
configuration, shared host gotchas, etc. There's also a chance I've  
covered and sooped up a concept in the working copy for the 1.2  
manual. More details on that as it comes.

Thanks,

-- John

--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups "Cake 
PHP" 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