Thanks Chris, and grigri

I understand the differnce between a manual and I think the purpose of
any good document is to at least inform the reader about the
parameters of any method. The api is so poorly documented that in most
case it does not tell in any detail about the parameters. For example
in one case, it tells that options array is just like form_remote_tag

http://api.cakephp.org/1.2/class_ajax_helper.html#eb375b9b0a13e633e2117a31b21129f6

The only option for me was to go through the code and if I could find
what individual associative component does the function expect in the
code. This is not very smart on the part of the documentation. They
probably used some tool to grab the comments based document and spit
it there.

Its better then nothing, but I was not expecting this as cakephp
itself is wonderful tool, so the document should at least match the
standards.

Maybe a user editable wiki will do the job, or something like php.net
which has user contributions as part of the manual.

My 2 cents




On Dec 14, 11:51 am, "Chris Hartjes" <[EMAIL PROTECTED]> wrote:
> On Dec 14, 2007 10:35 AM, WordPress Guru <[EMAIL PROTECTED]> wrote:
>
>
>
> > Thanks and it works.
>
> > Just one more thing. I am totally frustrated with the documentation
> > available at api.cakephp.org . Do you guys have some other resource to
> > look to ?
>
> Well, api.cakephp.org is, well, documentation on the API.  Not a
> manual itself.  Check out the in-progress documentation for 1.2 
> athttp://tempdocs.cakephp.org.  Also check outhttp://bakery.cakephp.org.
>
> --
> Chris Hartjes
>
> My motto for 2007:  "Just build it, damnit!"
>
> @TheKeyboard -http://www.littlehart.net/atthekeyboard
--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups "Cake 
PHP" group.
To post to this group, send email to cake-php@googlegroups.com
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