Принимаются пожелания по улучшению официальной документации

Обсуждение документации. Переводы Cookbook и авторские рецепты.
Ekstazi
Сообщения: 1428
Зарегистрирован: 2009.08.20, 22:54
Откуда: Молдова, Бельцы
Контактная информация:

Re: Принимаются пожелания по улучшению официальной документа

Сообщение Ekstazi »

у вопрдпресса доки имхо хуже.
Аватара пользователя
samdark
Администратор
Сообщения: 9489
Зарегистрирован: 2009.04.02, 13:46
Откуда: Воронеж
Контактная информация:

Re: Принимаются пожелания по улучшению официальной документа

Сообщение samdark »

Вообще после прочтения всей документации вопрос должен был отпасть. Попробую что-нибудь придумать на эту тему.

Аккордеон был сделан по пожеланиям разработчиков, которые пользуются документацией. До этого как раз было всё развёрнуто.
Аватара пользователя
AlexG
Сообщения: 35
Зарегистрирован: 2012.07.22, 21:23
Откуда: Украина, Харьков/PФ
Контактная информация:

Re: Принимаются пожелания по улучшению официальной документа

Сообщение AlexG »

Нашел маленькую неточность описании класса CFileHelper, описание функции validatePath

$fileTypes array list of file name suffix (without dot). Only files with these suffixes will be copied. - выделенного тут быть не должно, видимо копипаста из ф-ии копирования
Ищу миддла.
Аватара пользователя
samdark
Администратор
Сообщения: 9489
Зарегистрирован: 2009.04.02, 13:46
Откуда: Воронеж
Контактная информация:

Re: Принимаются пожелания по улучшению официальной документа

Сообщение samdark »

Тут, наверное, надо вместо copied использовать validated, верно?
Аватара пользователя
AlexG
Сообщения: 35
Зарегистрирован: 2012.07.22, 21:23
Откуда: Украина, Харьков/PФ
Контактная информация:

Re: Принимаются пожелания по улучшению официальной документа

Сообщение AlexG »

Sam Dark писал(а):Тут, наверное, надо вместо copied использовать validated, верно?
Судя по коду, да :)

Вот еще заметил, там же:
$fileTypes array list of file name suffix (without dot). Only files with these suffixes will be copied.
$exclude array list of directory and file exclusions. Each exclusion can be either a name or a path. If a file or directory name or path matches the exclusion, it will not be copied. For example, an exclusion of '.svn' will exclude all files and directories whose name is '.svn'. And an exclusion of '/a/b' will exclude file or directory '$src/a/b'. Note, that '/' should be used as separator regardless of the value of the DIRECTORY_SEPARATOR constant.
Ищу миддла.
Аватара пользователя
samdark
Администратор
Сообщения: 9489
Зарегистрирован: 2009.04.02, 13:46
Откуда: Воронеж
Контактная информация:

Re: Принимаются пожелания по улучшению официальной документа

Сообщение samdark »

Всё поправил. Спасибо.
rosko
Сообщения: 2
Зарегистрирован: 2009.12.10, 18:26

Re: Принимаются пожелания по улучшению официальной документа

Сообщение rosko »

На странице "Реляционная Active Record" в разделе "Параметры реляционного запроса" для параметра on написано: "Данный параметр неприменим для связей типа MANY_MANY.".

Но я использую как раз on при MANY_MANY, и все работает.
Это я что-то делаю неправильно или инфа немного устарела?
Аватара пользователя
samdark
Администратор
Сообщения: 9489
Зарегистрирован: 2009.04.02, 13:46
Откуда: Воронеж
Контактная информация:

Re: Принимаются пожелания по улучшению официальной документа

Сообщение samdark »

А к какому из двух JOIN он применяется?
yan
Сообщения: 942
Зарегистрирован: 2011.03.23, 09:28
Откуда: Уфа

Re: Принимаются пожелания по улучшению официальной документа

Сообщение yan »

В описании http://www.yiiframework.com/doc/api/1.1 ... lue-detail указан тип "public string $value;" хотя может быть и анонимная функция, что значительно расширяет возможности применения, наверняка та же недосказаность есть в других местах где применяется evaluateExpression()
Аватара пользователя
belka2007
Сообщения: 12
Зарегистрирован: 2012.11.01, 22:01

Re: Принимаются пожелания по улучшению официальной документа

Сообщение belka2007 »

Было бы очень удобно, если бы, велась история изменений в документации с датами последнего редактирования.
Ну или хотя бы общую дату последнего обновления документации.
Аватара пользователя
samdark
Администратор
Сообщения: 9489
Зарегистрирован: 2009.04.02, 13:46
Откуда: Воронеж
Контактная информация:

Re: Принимаются пожелания по улучшению официальной документа

Сообщение samdark »

Можно получить из git...
Аватара пользователя
dimon
Сообщения: 7
Зарегистрирован: 2013.04.17, 00:27

Re: Принимаются пожелания по улучшению официальной документа

Сообщение dimon »

Добрый день, не знаю насколько целесообразно, но я думаю было бы не плохо добавить краткое описание об установке Yii прямо на сервер. Может я не внимательно читал, но пока что не нашел об этом в доке...)
2. Более понятнее сделать описание для подключения БД.

Извините если что, просто я пишу глазами новичка, который впервые взял в руки yii.))
Аватара пользователя
samdark
Администратор
Сообщения: 9489
Зарегистрирован: 2009.04.02, 13:46
Откуда: Воронеж
Контактная информация:

Re: Принимаются пожелания по улучшению официальной документа

Сообщение samdark »

Нет никакой установки. Просто заливается по FTP/SSH и всё.

2. http://yiiframework.ru/doc/guide/ru/database.dao
Аватара пользователя
AlexSimp
Сообщения: 568
Зарегистрирован: 2013.04.09, 11:30
Откуда: Киев

Re: Принимаются пожелания по улучшению официальной документа

Сообщение AlexSimp »

Александр, отвечая на вопрос одному из форумчан, не смог найти в официальной документации Клипы и Декораторы (кроме раздела Альтернативный язык шаблонов), о которых прочел в вашей книге... Невнимательно искал? Возможно, имеет смысл добавить информацию о них в раздел Представление?
Жду, когда на форуме появятся вопросы "как сделать сайт на Yii?" и "как сложить два числа с помощью Yii?"...
Аватара пользователя
samdark
Администратор
Сообщения: 9489
Зарегистрирован: 2009.04.02, 13:46
Откуда: Воронеж
Контактная информация:

Re: Принимаются пожелания по улучшению официальной документа

Сообщение samdark »

Сделаем. Добавил напоминалку на github https://github.com/yiisoft/yii/issues/2476
Аватара пользователя
AlexSimp
Сообщения: 568
Зарегистрирован: 2013.04.09, 11:30
Откуда: Киев

Re: Принимаются пожелания по улучшению официальной документа

Сообщение AlexSimp »

Предлагаю добавить в раздел гайда Псевдоним пути и пространство имён примечание о нерекурсивности импорта директорий:
Importing a directory does not import any of its subdirectories.
http://www.yiiframework.com/doc/api/1.1 ... ort-detail

А то народ не знает, видимо доки читают реже чем гайд.
Жду, когда на форуме появятся вопросы "как сделать сайт на Yii?" и "как сложить два числа с помощью Yii?"...
Аватара пользователя
AlexSimp
Сообщения: 568
Зарегистрирован: 2013.04.09, 11:30
Откуда: Киев

Re: Принимаются пожелания по улучшению официальной документа

Сообщение AlexSimp »

Во время разбирательств с валидаторами, активно пользовался статьей Краткий справочник по валидации, но заметил некоторые несоответствия с оригиналом: во-первых, отсутствует раздел про сценарии, но главное - не указаны значения по-умолчанию для параметров валидации. В случае с allowEmpty это весьма актуально, т.к. они разные для разных валидаторов.
Жду, когда на форуме появятся вопросы "как сделать сайт на Yii?" и "как сложить два числа с помощью Yii?"...
Аватара пользователя
samdark
Администратор
Сообщения: 9489
Зарегистрирован: 2009.04.02, 13:46
Откуда: Воронеж
Контактная информация:

Re: Принимаются пожелания по улучшению официальной документа

Сообщение samdark »

Если есть время, можно сделать на эту тему pull-request: https://github.com/samdark/yiiframework_ru_cookbook
Ответить