Страница 1 из 1

Документация как у ActionScript

Добавлено: 2012.01.05, 05:31
delancer
Было бы круто если дока Yii была как у ActionScript
Допустим взять http://help.adobe.com/ru_RU/FlashPlatfo ... ction.html
Всё с примерами, с хорошим описанием

Re: Документация как у ActionScript

Добавлено: 2012.01.05, 08:50
esche
delancer писал(а):Было бы круто если дока Yii была как у ActionScript
Допустим взять http://help.adobe.com/ru_RU/FlashPlatfo ... ction.html
Всё с примерами, с хорошим описанием
А чем не устраивает такое: http://www.yiiframework.com/doc/api/ (ссылочка API в шапке форума...) и такое: http://www.yiiframework.com/wiki/ (тут скорее рецепты... некоторые из них переведены на русский).
Если есть конкретные пожелания (пример, например, который имеет смысл куда-нибудь приаттачить... или рецепт, которого не хватает) - пишите.. сюда, к примеру :)
p.s. На всякий случай дам ссылку на обсуждение про перевод API

Re: Документация как у ActionScript

Добавлено: 2012.01.05, 10:46
timlar
delancer писал(а):Допустим взять http://help.adobe.com/ru_RU/FlashPlatfo ... ction.html
Посмотрел... Вырвиглазно и как-то неудобно. Документация по yii фреймворку намного удобнее сделана.

Re: Документация как у ActionScript

Добавлено: 2012.01.05, 11:02
delancer
Ну вот допустим взять http://www.yiiframework.com/doc/api/1.1/CDbExpression
Почему бы не написать пару примеров использования? в описании разве что написано про выражение и параметры, но не показано как это сделать... для новичков это трудно понять и для тех кто не знает английский - ваще крах!
хотя бы такое

Код: Выделить всё

    public function beforeSave() {
        $this->date = new CDbExpression('NOW()');
        return parent::beforeSave();
    }
 
то же пример из того что сейчас написано в доке

Код: Выделить всё

        $this->login = new CDbExpression('LOWER(:login)',array(":login"=>$this->login));
 

Re: Документация как у ActionScript

Добавлено: 2012.01.05, 11:05
delancer
timlar писал(а):
delancer писал(а):Допустим взять http://help.adobe.com/ru_RU/FlashPlatfo ... ction.html
Посмотрел... Вырвиглазно и как-то неудобно. Документация по yii фреймворку намного удобнее сделана.
Я имел ввиду что там всё с описанием подробным, и во многих местах идут примеры, показаны взаимодействия с другими компонентами.
Ну а за удобство просмотра у Yii документация очень нравится, разве что хотелось бы чтобы у каждого компонента были описаны не большие примеры и желательно не по одному, а по несколько

Re: Документация как у ActionScript

Добавлено: 2012.01.05, 11:12
delancer
А CDbCriteria? такой популярный компонент фреймворка, а в доке нет примеров... разве что ктото привёл примеры в коментах

Re: Документация как у ActionScript

Добавлено: 2012.01.05, 11:13
timlar
Примеров на все случаи жизни не напишешь. Да и смысла не вижу. Есть форумы, конференции. Так же самому подумать лишним не будет. Неоднократно говорилось, что порог вхождения у yii довольно высок.

Re: Документация как у ActionScript

Добавлено: 2012.01.05, 11:16
timlar
delancer писал(а):А CDbCriteria? такой популярный компонент фреймворка, а в доке нет примеров... разве что ктото привёл примеры в коментах
А чем не устраивает пример из http://yiiframework.ru/doc/guide/ru/database.ar ? Там в параграфе "Чтение записи".

Re: Документация как у ActionScript

Добавлено: 2012.01.05, 11:18
delancer
timlar писал(а):
delancer писал(а):А CDbCriteria? такой популярный компонент фреймворка, а в доке нет примеров... разве что ктото привёл примеры в коментах
А чем не устраивает пример из http://yiiframework.ru/doc/guide/ru/database.ar ? Там в параграфе "Чтение записи".
всё устраивает на УРА, но только хотелось бы чтобы эти все примеры были продублированы в доку... не всегда на wiki и рецепты смотрю, в основном в API

Re: Документация как у ActionScript

Добавлено: 2012.01.05, 14:10
esche
delancer писал(а):всё устраивает на УРА, но только хотелось бы чтобы эти все примеры были продублированы в доку... не всегда на wiki и рецепты смотрю, в основном в API
И API и код очень подробно документированы. Дублировать _официальный_ гайд, видимо, посчитали излишним.