Качество документации.

Обсуждение документации. Переводы Cookbook и авторские рецепты.
Аватара пользователя
lancecoder
Сообщения: 2532
Зарегистрирован: 2012.06.26, 17:16

Re: Качество документации.

Сообщение lancecoder »

а потом вы будите продавать курс молодого бойца? :-D
alexyarik
Сообщения: 140
Зарегистрирован: 2012.09.06, 15:07

Re: Качество документации.

Сообщение alexyarik »

нет, попрошу админа расширить руководство для начинающих. Дам свой материал, если заинтересует мое мнение.
Все привыкли пользоваться например этим сайтом, а принять участие в развитии не хотят.
Аватара пользователя
lancecoder
Сообщения: 2532
Зарегистрирован: 2012.06.26, 17:16

Re: Качество документации.

Сообщение lancecoder »

сразу бы написали, что желаете помочь Yii сообществу в частности новичкам, а то сразу задаете вопросы ну не там форуме, вам бы сначала на php надо научиться
Аватара пользователя
BrusSENS
Сообщения: 565
Зарегистрирован: 2012.07.26, 06:51
Откуда: Новороссийск
Контактная информация:

Re: Качество документации.

Сообщение BrusSENS »

alexyarik писал(а):Согласен с автором темы. Для базового старта очень мало примеров и пояснений.
Такое ощущение, что тем кто выучился просто лень внести свою лепту в развитии руководства по фреймворку.
Уже второй месяц изучаю, читаю документацию на английском, вникаю в код демо блога, но пока нет ясной картины.
Трудно понять принцип работы фреймворка начинающему.
Руководство написано так мол лишь бы отвязались.
Я ещё и месяца не использую Yii, документации вполне хватает для работы с фреймворком, есть конечно недочёты, но это уже по моему если ты создаёшь что то более глобальное :)
Native Web - небольшой блог о веб разработке (временно на ремонте)
Режим обслуживания сайта для Yii 2.x.x
ShNURoK
Сообщения: 168
Зарегистрирован: 2012.04.12, 05:44
Контактная информация:

Re: Качество документации.

Сообщение ShNURoK »

http://yiiframework.ru/doc/guide/ru/topics.security
В CSRF, в отличие от межсайтового скриптинга, основанного на доверии пользователя к некоторому сайту, используется доверие сайта определённому пользователю.
Мне кажется это вынос мозга. Особенно тем, кто только начинает разбираться.
Почему инъекция вредоносного кода в сайт - это доверие пользователя к некоторому сайту.
А просмотр на некотором сайте вредоносной картинки и выполняющей действия на родном сайте - это доверие сайта определённому пользователю.

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

Re: Качество документации.

Сообщение samdark »

Там выше практический пример дан, так что всё не так плохо, как в отрыве от контекста. Тем более, что про собственно инъекцию там ничего нет. Разбирается XSS и CSRF.
astronin
Сообщения: 606
Зарегистрирован: 2012.01.30, 17:46

Re: Качество документации.

Сообщение astronin »

Пишу сюда, т.к. то что пишу, в принципе претензия(хотя может просто мне показалось не очевидным) к документации. Но английской. Но поскольку на английском форуме не разрешают писать, приходится сюда. Хоть в русской документации будет отмечено.

Класс CActiveRecord
Функция deleteAll() - Deletes rows with the specified condition.

Вопрос в том, что для этой функции не сказано, что не вызывается методы beforeDelete/afterDelete. Глубже в кодах вообще оказывается AR не работает. Было бы не плохо в документации этот момент указывать. А то как-то догадаться несколько сложно...
Benjamin
Сообщения: 11
Зарегистрирован: 2011.08.02, 16:47

Re: Качество документации.

Сообщение Benjamin »

Вопрос по http://yiiframework.ru/doc/guide/ru/database.arr
Как в таблице tbl_post_category может быть 2 PK?
Аватара пользователя
samdark
Администратор
Сообщения: 9489
Зарегистрирован: 2009.04.02, 13:46
Откуда: Воронеж
Контактная информация:

Re: Качество документации.

Сообщение samdark »

А кто сказал, что там их два?
Benjamin
Сообщения: 11
Зарегистрирован: 2011.08.02, 16:47

Re: Качество документации.

Сообщение Benjamin »

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

Re: Качество документации.

Сообщение samdark »

Ну да.
puritania
Сообщения: 43
Зарегистрирован: 2012.04.18, 06:26
Откуда: Челябинск
Контактная информация:

Re: Качество документации.

Сообщение puritania »

Предлагаю поправить ссылки в http://www.yiiframework.com/doc/api/1.1 ... ate-detail параметра "$conditions", вместо "where property" на ссылку на "where() method", где собственно и описано задание условий.
Аналогично сменить ссылку и в описании http://www.yiiframework.com/doc/api/1.1 ... ere-detail
Аватара пользователя
lancecoder
Сообщения: 2532
Зарегистрирован: 2012.06.26, 17:16

Re: Качество документации.

Сообщение lancecoder »

ну так верно же все, так сразу видно что есть гет и сет, а вы на какой конкретно метод хотите ссылку?
puritania
Сообщения: 43
Зарегистрирован: 2012.04.18, 06:26
Откуда: Челябинск
Контактная информация:

Re: Качество документации.

Сообщение puritania »

lancecoder писал(а):ну так верно же все, так сразу видно что есть гет и сет, а вы на какой конкретно метод хотите ссылку?
на метод where().
То что get и set это понятно, но там ссылка указанна в контексте "Please refer to where on how to specify conditions.", а там гетер и сетер, у которых в комментариях ссылки обратно на property where.
Аватара пользователя
lancecoder
Сообщения: 2532
Зарегистрирован: 2012.06.26, 17:16

Re: Качество документации.

Сообщение lancecoder »

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

Re: Качество документации.

Сообщение samdark »

Попробую поправить. Кажется, именно эта штука — засада с парсером документации.
alexyarik
Сообщения: 140
Зарегистрирован: 2012.09.06, 15:07

Re: Качество документации.

Сообщение alexyarik »

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

Re: Качество документации.

Сообщение samdark »

Поконкретнее бы…
alexyarik
Сообщения: 140
Зарегистрирован: 2012.09.06, 15:07

Re: Качество документации.

Сообщение alexyarik »

Вот эта статья по основам для начинающих http://www.yiiframework.com/wiki/268/how-to-learn-yii/
и эта для начинающих http://www.yiiframework.com/wiki/250/yii-for-beginners/
вот для начинающих по комментариям http://www.yiiframework.com/doc/blog/1. ... ent.create
Это были из последних которые я смотрел.
Аватара пользователя
samdark
Администратор
Сообщения: 9489
Зарегистрирован: 2009.04.02, 13:46
Откуда: Воронеж
Контактная информация:

Re: Качество документации.

Сообщение samdark »

И куда из добавить?
Ответить