Сложно найти какой-нибудь вопрос по php, и программированию в целом, где бы не нашлось умника, который скажет "читайте документацию, там все есть". Но лично мой опыт поиска информации показывает, что документации - самый бестолковый источник информации. И вот сегодняшний пример - Yii2, виджет ActiveForm, его метод begin() Что говорит документация: Ну вот спрашивается и что? Откуда мне знать что надо писать в параметрах? Документация не дает никакого ответа на этот вопрос. Смотрю примеры: PHP: ActiveForm::begin([ 'action' => ['index'], 'method' => 'get', ]) PHP: ActiveForm::begin([ 'method' => 'GET', 'id' => 'search_responce_form', 'action' => '/cabinet/search-review', 'options' => ['class' => 'flexrow'], ]) PHP: ActiveForm::begin([ 'options' => ['onlick' => 'return false'] ] Становится чуть более понятно, но все равно, приходится перебирать кучу примеров, экспериментировать самому, чтобы понять, какие могут быть параметры, их значения, и что они в итоге выводят в html. Так в чем польза от этих документаций? Если кто-то считает, что я не умею ими пользоваться - с удовольствием послушаю как же ими пользоваться.
документация бывает разной, хорошей и плохой, полной и краткой, полезной и бесполезной.... вопрос качества документации - он как и с качеством кода... где хорошая, где-то не очень но согласитесь, что лучше хоть какая-то информация, чем вообще никакой ну и интернет тем и хорош что существует множество источников информации,а не один
тогда смотри в Class Reference http://www.yiiframework.com/doc-2.0/index.html помогает сразу читать код framework и поиск хороший. --- Добавлено --- Просто читаем код https://github.com/yiisoft/yii2/blob/master/framework/base/Widget.php#L85 --- Добавлено --- Она помогает быстро ориентироваться по возможностям framework, так как если ты не ищешь в интернете, то всегда можно почитать код самого yii2 и документация быстро поможет найти с какой точки начать капать. Можно погуглить если не хочешь разбираться сам. Вот так и живём. --- Добавлено --- http://www.yiiframework.com/doc-2.0/yii-widgets-activeform.html -> begin() -> http://www.yiiframework.com/doc-2.0/yii-base-widget.html#begin()-detail -> можно жать на глаз, чтобы посмотреть код, глаз чуть выше прокрути
@Walk, если прочитать только эту строчку документации, то не понятно. Если до этого прочитать и вот это тоже: http://www.yiiframework.com/doc-2.0/guide-concept-components.html, http://www.yiiframework.com/doc-2.0/guide-concept-properties.html, то всё понятно. У yii2 специфическая инициализация полей через массивы. Когда я беру новый фреймворк, я пробегаю руководство от начала до конца. У меня нету суперпамяти, и всё не запоминается, но что-то начинаешь понимать. Пробежавшись по первой ссылке, становится понятно, что в массив можно пихать всё, что здесь описано как публичные свойства. И по названию Key Concepts сразу понятно, что это надо прочесть обязательно