Monday, August 30, 2010

Re: Function documentation?

@geoB
>Thank you for the valuable insight into the Cake Way.
Any time. Keep at it, cake is really really awesome!

@j.blotus
And there are thousands more who likely disagree with you. People
like you chime in any time the documentation is knocked. For most
people wanting to use cake I assume they are amateur developers like
myself and my not be so familiar with the MVC design. I understood
the concept but using something in practice is a much different ball
game.

Here's a simple scenario that I see often: how do you pass info from
one action to another. Most people really aren't so stupid to know
they can pass information via a cookie, session, URL parameters,
etc...so I assume when people ask this elementary web-development
question I always they mean "the cake way" unless they prove
otherwise. Why some of you are so against the inclusion of more
examples of "the cake way" of doing common tasks into the common tasks
section of the handbook completely baffles me. The "real" world
example (blog post) only demonstrates so much and unfortunately it's
barely the tip of the ice burg.

On Aug 30, 7:27 am, geoB <truckeetr...@yahoo.com> wrote:
> @Anthony:
>
> Thank you for the valuable insight into the Cake Way.
>
> I started with it with the intention of rewriting an existing online
> application.  The documentation struck me as a good set of reminders
> for those who already "got it".  I've only rebuilt my database once.
> So far.  I suppose "rapid development" is relative.  Since my
> development is all volunteer I guess I'm a bit impatient.
>
> George
>
> On Aug 29, 9:28 pm, Anthony <anthony.c.fra...@gmail.com> wrote:
>
> > The documentation covers this but you REALLY gotta read into it
>
> > These two pages are vital to "getting" cake IMO.
>
> >http://book.cakephp.org/view/890/Understanding-Model-View-Controllerh...
>
> > Once these two really begin sinking in these two pages will likely
> > become your next best source of info:
>
> >http://book.cakephp.org/view/1039/Associations-Linking-Models-Togethe...
>
> > I'm with you in that some of the documentation is lacking on examples
> > on doing things the "cake way" but really good on the technical side
> > once you figure out the "cake way".
>
> > FWIW, I've been building a site in my spare time but have restructured
> > everything twice because I find something new in cake that makes most
> > of what I've already done redundant.  IE: not making use of elements
> > or not understanding how bad-ass contain is, or realizing that
> > ultimately I have the control and the index, view, delete, add
> > functions that the tutorial goes on about aren't really important, its
> > all in the naming, keying and structuring.
>
> > On Aug 29, 9:31 pm, geoB <truckeetr...@yahoo.com> wrote:
>
> > > "When someone browsers to /controller/index, it calls the index()
> > > method for
> > > the controller, which usually contains a find call for the model
> > > associated
> > > with the controller and sets a variable which is available in the
> > > index view
> > > for the controller in question. "
>
> > > This is the kind of information I was looking for.  I am more of a
> > > deductive than inductive logic person.  The use of the method in the
> > > tutorial doesn't explain to me what it's doing there or how it is
> > > used.  (I've not found any mention of an index() method in any
> > > controller.  Why is that?)
>
> > > Thanks immensely for clearing this up.
>
> > > George
>
> > > On Aug 29, 7:01 pm, Greg Skerman <gsker...@gmail.com> wrote:
>
> > > > the index() method in your controllers wont have any parameters...or maybe
> > > > it will - its up to you.
>
> > > > Hell you don't even have to define one if you don't want to.
>
> > > > When someone browsers to /controller/index, it calls the index() method for
> > > > the controller, which usually contains a find call for the model associated
> > > > with the controller and sets a variable which is available in the index view
> > > > for the controller in question.
>
> > > > Take a look at the blog tutorial in the book - it'll show you exactly how
> > > > this works.
>
> > > > On Mon, Aug 30, 2010 at 10:57 AM, geoB <truckeetr...@yahoo.com> wrote:
> > > > > I have searched Google, CakePHP Google Group, API Controller
> > > > > documentation (versions 1.2, 1.3), API AppController documentation
> > > > > (versions 1.2, 1.3) and have found no useful information on the
> > > > > parameters used by the index method.  Search terms include "index
> > > > > method", "index method" & documentation, "Index method" & syntax.  I
> > > > > ain't no dummy, and I don't expect to be spoon-fed.
>
> > > > > Sure, my understanding isn't what it could be.  That's why I read the
> > > > > documentation.  But reading alone does not create comprehension.
> > > > > Actual use of the material to observe its effects is required as
> > > > > well.  But I can't try to recreate something I cannot find
> > > > > documentation on.
>
> > > > > Perhaps a more specific reference would be useful.  I have read the
> > > > > manual at least twice now, and I know I'm not ready for the exam.
>
> > > > > g
>
> > > > > On Aug 29, 1:18 pm, "j.blotus" <j.blo...@gmail.com> wrote:
> > > > > > i think you need to start again from the beginning of the manual.
> > > > > > index() is controller action. It gets records from the Model and sends
> > > > > > them to the view. It sounds like you don't really understand the way
> > > > > > CakePHP uses MVC. Also, the core has an extensive API  for versions
> > > > > > 1.1, 1.2, and 1.3.
>
> > > > > > On Aug 28, 1:08 pm, geoB <truckeetr...@yahoo.com> wrote:
>
> > > > > > > I am trying to get started with CakePHP and am experiencing some
> > > > > > > frustration with the documentation.  (fwiw, I am moderately well
> > > > > > > experienced with PHP.)  For example, I was following the blog tutorial
> > > > > > > at the CakePHP website, only trying to adapt it to the database I
> > > > > > > intend to work with.  I learned that the index() function was
> > > > > > > referring to an index of a table.  So I started to look for the syntax
> > > > > > > of the index() function to no avail.  There does not appear to be a
> > > > > > > function reference anywhere that I can find.
>
> > > > > > > In general, how does one learn the syntax of a specific function?  I
> > > > > > > hope it's not trial and error.  Please point me in the right direction
> > > > > > > for documentation resources.
>
> > > > > > > Thanks.
>
> > > > > > > George
>
> > > > > Check out the new CakePHP Questions sitehttp://cakeqs.organdhelpothers
> > > > > with their CakePHP related questions.
>
> > > > > 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
> > > > > cake-php+unsubscribe@googlegroups.com<cake-php%2Bunsubscribe@googlegroups.com>For more options, visit this group at
> > > > >http://groups.google.com/group/cake-php?hl=en

Check out the new CakePHP Questions site http://cakeqs.org and help others with their CakePHP related questions.

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
cake-php+unsubscribe@googlegroups.com For more options, visit this group at http://groups.google.com/group/cake-php?hl=en

No comments: