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

Обсуждение документации. Переводы Cookbook и авторские рецепты.
Ответить
delancer
Сообщения: 58
Зарегистрирован: 2011.03.11, 19:37
Откуда: Украина, Донецк

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

Сообщение delancer »

Было бы круто если дока Yii была как у ActionScript
Допустим взять http://help.adobe.com/ru_RU/FlashPlatfo ... ction.html
Всё с примерами, с хорошим описанием
esche
Сообщения: 1054
Зарегистрирован: 2010.11.24, 03:39

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

Сообщение 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
...
Аватара пользователя
timlar
Сообщения: 1382
Зарегистрирован: 2009.09.19, 17:49
Откуда: Украина, Днепропетровск
Контактная информация:

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

Сообщение timlar »

delancer писал(а):Допустим взять http://help.adobe.com/ru_RU/FlashPlatfo ... ction.html
Посмотрел... Вырвиглазно и как-то неудобно. Документация по yii фреймворку намного удобнее сделана.
Twitter: @timlar_ua
delancer
Сообщения: 58
Зарегистрирован: 2011.03.11, 19:37
Откуда: Украина, Донецк

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

Сообщение 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));
 
Последний раз редактировалось delancer 2012.01.05, 11:07, всего редактировалось 1 раз.
delancer
Сообщения: 58
Зарегистрирован: 2011.03.11, 19:37
Откуда: Украина, Донецк

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

Сообщение delancer »

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

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

Сообщение delancer »

А CDbCriteria? такой популярный компонент фреймворка, а в доке нет примеров... разве что ктото привёл примеры в коментах
Аватара пользователя
timlar
Сообщения: 1382
Зарегистрирован: 2009.09.19, 17:49
Откуда: Украина, Днепропетровск
Контактная информация:

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

Сообщение timlar »

Примеров на все случаи жизни не напишешь. Да и смысла не вижу. Есть форумы, конференции. Так же самому подумать лишним не будет. Неоднократно говорилось, что порог вхождения у yii довольно высок.
Twitter: @timlar_ua
Аватара пользователя
timlar
Сообщения: 1382
Зарегистрирован: 2009.09.19, 17:49
Откуда: Украина, Днепропетровск
Контактная информация:

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

Сообщение timlar »

delancer писал(а):А CDbCriteria? такой популярный компонент фреймворка, а в доке нет примеров... разве что ктото привёл примеры в коментах
А чем не устраивает пример из http://yiiframework.ru/doc/guide/ru/database.ar ? Там в параграфе "Чтение записи".
Twitter: @timlar_ua
delancer
Сообщения: 58
Зарегистрирован: 2011.03.11, 19:37
Откуда: Украина, Донецк

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

Сообщение delancer »

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

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

Сообщение esche »

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