Comments: Controller Extensions ("Components")

By poppitypop on 23/6/08

1 - cleaning needed

Why are view, model and controller extensions taught before views, models and controllers? I remember the first time a read this (like 3 weeks ago) I was like "What the frik is this talking about". Now I've already programed 1/9 of my first website with cakePHP and I haven't even come across any real needs for these extensions! And why is it teaching the beforeFilter, beforeRender etc here? I think that will just confuse new people. Talk about the necessary things first. Start with teaching how to create a static page (one like /pages/staticPage). Then a page with a controller, without a model. Then talk about models. After that show how you can change the layout, and how you can have multiple layouts and such. Extensions should be one of the last things to talk about.

I do not think people should be afraid to simplify things when writing this manual, even if that means writing things that are not 100% true. The manual is for new people, the api if for the ones that already have it learned. Or maybe we could have two manuals?

Jonah

By miracol on 26/8/08

2 - Re: cleaning needed

@ Jonah

Thats really true.

CakePHP is really great, but for the documentation we should look at http://codeigniter.com as an example of good documentation !!

Login to add a comment