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

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

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

Сообщение delancer » 2012.01.05, 05:31

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

esche
Сообщения: 1054
Зарегистрирован: 2010.11.24, 03:39

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

Сообщение esche » 2012.01.05, 08:50

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 » 2012.01.05, 10:46

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

delancer
Сообщения: 58
Зарегистрирован: 2011.03.11, 19:37
Откуда: Украина, Донецк

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

Сообщение delancer » 2012.01.05, 11:02

Ну вот допустим взять 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 » 2012.01.05, 11:05

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

delancer
Сообщения: 58
Зарегистрирован: 2011.03.11, 19:37
Откуда: Украина, Донецк

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

Сообщение delancer » 2012.01.05, 11:12

А CDbCriteria? такой популярный компонент фреймворка, а в доке нет примеров... разве что ктото привёл примеры в коментах

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

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

Сообщение timlar » 2012.01.05, 11:13

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

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

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

Сообщение timlar » 2012.01.05, 11:16

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

delancer
Сообщения: 58
Зарегистрирован: 2011.03.11, 19:37
Откуда: Украина, Донецк

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

Сообщение delancer » 2012.01.05, 11:18

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

esche
Сообщения: 1054
Зарегистрирован: 2010.11.24, 03:39

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

Сообщение esche » 2012.01.05, 14:10

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

Ответить