Some parts of the manual are just wrong - the code examples for ACL
for example. Others don't seem to go far enough - I still can't work
out how to use a plugin.
But everybody has talked about the manual and the important thing is
that there is one.
I would like to see more verbose release notes, including reasons for
deprecation of code. I still can't see any sense in making find's
parameters so amorphous in order to eliminate a function (findAll):
* If no fields are specified, then 'id' is used for key and 'model-
>displayField' is used for value.
* If a single field is specified, 'id' is used for key and
specified field is used for value.
* If three fields are specified, they are used (in order) for key,
value and group.
* Otherwise, first and second fields are used for key and value.
This is just confusing. I don't want to read the API every time I use
this function - I'm now over forty and the goat's cheese to grey
matter ratio errs in favour of the cheese. I have trouble remembering
the names of my children. I guess most people will just end up writing
their own utility findAll.
Okay, I'm now, apparently, way off topic, but you did ask:" What is
the most confusing? What's most needed and
missing?".
In summary, accurate official (not bakery) examples of usage and loads
of them.
Release notes that tell us what we need to know, not that"...trac 4391
was changed from bug to embellishment..."
I guess the ultimate would be a PHP style chm function reference, not
that I'm a fan of chm.
> > How are we doing? What is the most confusing? What's most needed and
> > missing? I have a punchlist of my own, but I'm looking for input from
> > you guys, especially the new ones.
--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups
"CakePHP" 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
-~----------~----~----~----~------~----~------~--~---
