User guide issue

[sergeyklay]

Yesterday, the first time I tried to read Gleez Conventions guide/gleez/gleez.conventions and understood that understood nothing :)

For example in this manual is not clear whether I should create controllers/myapp dir or not?

Your controllers should be located inside classes/controller/myapp.

...

You declare a Route for the site frontend like this:

Route::set('site/myapp', '<myapp>(/<action>(/<id>))')
    ->defaults(array(
        'controller' => 'defaultcontroller',
        'action'     => 'index',
));

Hmm.. What is <myapp>? I should have classes/controller/myapp/defaultcontroller.php?

You don't need to set the directory parameter because it will always be the name of your app.

Hence all the same I should create controllers/myapp dir?

But bellow:

If you want your app to automatically check user permissions as declared in your init.php, you must extend Controller_Base ...

class Controller_MyApp extends Template {

    public function action_index()
    {

    }
}

At least three of the error (or at least bit magic)

All that is written below is also not obvious. I propose simplify documentation, or supplement it with more real-world examples that would help to understand what was going on, or fix some things and write more specifically.

I wanted a little supplement documentation. Frankly already begun to do, but then I understood what I was doing something wrong or don't understand what is written here and rolled back

[sandeepuno]

The documentation was pretty old and changed a lot. Need to overwrite a lot or start fresh.