Merge branch 'master' into step-0.3

githubjeka · githubjeka · commit 0ef3ea095874 · 2015-07-10T12:08:17.000+03:00
diff --git a/readme.md b/readme.md
@@ -1,4 +1,4 @@
-#Интерактивное руководство создания сайта на Yii2 на русском языке
+# Yii2 Интерактивное руководство создания сайта на русском языке
 
 ## Содержание
 
@@ -50,16 +50,16 @@ php -S localhost:9000
 
 ### Как обновить руководство до актуального состояния?
 
-Самый простой способ удалить учебник и повторить шаги из секции "Установка руководства".
+Самый простой способ - удалить учебник и повторить шаги из секции "Установка руководства".
 
-Второй способ скачать только отличия, которых в вашей версии руководства нету. Для этого выполните:
+Второй способ - скачать только отличия, которых в вашей версии руководства нету. Для этого выполните:
 
 ```
 cd yii2-tutorial
 git remote update
 ```
 
-Далее нужно обратить внимание на ветки git, которые имеют изменения и выполнить для них команды. Например для `master`:
+Далее нужно обратить внимание на ветки git, которые имеют изменения:
 
 ```
 git remote update                                         
@@ -69,23 +69,28 @@ git remote update
     remote: Total 3 (delta 0), reused 0 (delta 0), pack-reused 0
     Unpacking objects: 100% (3/3), done.                        
     From https://github.com/githubjeka/yii2-tutorial            
-       8d08bb3..537ddc6  master     -> origin/master  
-                                                            
-\yii2-tutorial (master)                          
-git pull                                                  
-    Updating 8d08bb3..537ddc6                                   
-    Fast-forward                                                
+       8d08bb3..537ddc6  master     -> origin/master
+       9aa3ff1..fb14483  step-1.2   -> origin/step-1.2                                    
+```
+  
+Изменения имеются в `master` и `step-1.2` ветках. Их необходимо локально обновить, выполнив команды `git checkout` и
+`git pull`. Например для `step-1.2` необходимо выполнить в yii2-tutorial:
+  
+```
+  git checkout step-1.2
+  git pull  
+                                               
+    Updating 9aa3ff1..fb14483                                   
+    Fast-forward                     
      readme.md | 15 ++++++++++++++-                             
      1 file changed, 14 insertions(+), 1 deletion(-)            
 ```
 
 ### Лицензия & Авторские права
 
-Весь материал (с) 2015 Evgeniy Tkachenko (<et.coder@gmail.com>)
-
 <a rel="license" href="http://creativecommons.org/licenses/by-nc-nd/3.0/deed.ru">
 <img alt="Creative Commons License" style="border-width:0" src="https://i.creativecommons.org/l/by-nc-nd/3.0/88x31.png" />
 </a>
 
-"Интерактивное руководство создания сайта на Yii2 на русском языке" распространятся под 
-<a rel="license" href="http://creativecommons.org/licenses/by-nc-nd/3.0/deed.ru">Creative Commons Attribution-NonCommercial-NoDerivs 3.0 Unported License.</a>
+Yii2 Интерактивное руководство создания сайта на русском языке (с) 2015 Evgeniy Tkachenko (<et.coder@gmail.com>)
+распространятся под <a rel="license" href="http://creativecommons.org/licenses/by-nc-nd/3.0/deed.ru">Creative Commons Attribution-NonCommercial-NoDerivs 3.0 Unported License.</a>
diff --git a/scripts/steps/step-000.2.md b/scripts/steps/step-000.2.md
@@ -364,7 +364,7 @@ New migration created successfully.
 
 ```php
 /**
- * Поддерживаемые типы данных для описания колонок.
+ * Поддерживаемые абстрактные типы данных для описания колонок.
  */
 const TYPE_PK = 'pk';
 const TYPE_BIGPK = 'bigpk';
@@ -385,7 +385,7 @@ const TYPE_BOOLEAN = 'boolean';
 const TYPE_MONEY = 'money';
 ```
 
-Миграция для таблицы, которая будет хранить данных из формы "Опрос", выглядит следующим образом(Подробнее в в файле
+Миграция для таблицы, которая будет хранить данных из формы "Опрос", выглядит следующим образом (подробнее в в файле
 `yii2-app-advanced/console/migrations/m150428_104828_interview.php`) :
 
 ```php
@@ -399,7 +399,7 @@ $this->createTable('{{%interview}}', [
 ], $tableOptions);
 ```
 
-Обратите внимание, что для описания типов данных используется не только константы, но и ключевые слова, например `. ' NOT NULL'`.
+Обратите внимание, что для описания типов данных используется не только константы, но и ключевые слова, например `NOT NULL`.
 Вы можете дополнять типы данных ключевыми словами до нужного вам состояния. 
 
 <p class="alert alert-info">
@@ -435,7 +435,7 @@ Gii включен в Advanced шаблоне приложения, если э
 php init --env=Development
 ```
 
-Чтобы попасть в Gii нужно перейти по ссылке <a href="/yii2-app-advanced/frontend/web/index.php?r=gii" target="_blank">
+Чтобы попасть в Gii, нужно перейти по ссылке <a href="/yii2-app-advanced/frontend/web/index.php?r=gii" target="_blank">
 index.php?r=gii</a> и выбрать пункт **Model Generator**.
  
 Если ваш сайт установлен не на локальном хосте, то скорее всего вы увидите на странице Gii ошибку доступа 403.
@@ -472,7 +472,7 @@ $config['modules']['gii'] = [
 - пространство имени `frontend\models`
 
 остальные поля оставляем как есть.
-Нажмём кнопку Preview (предпросмотр) и посмотрите `models\Interview.php` будущий код. После этого нажмите Generate.
+Нажмите кнопку Preview (предпросмотр) и посмотрите `models\Interview.php` - будущий код. После этого нажмите Generate.
 Всё наша модель создана и доступна по `/yii2-app-advanced/frontend/models/Interview.php`. Gii всё же не всесилен и 
 потребуется внести некоторые изменения в модель. Добавим элемент "проверочный код" - `verifyCode`, как свойство модели:
 
diff --git a/scripts/steps/step-001.0.md b/scripts/steps/step-001.0.md
@@ -2,22 +2,23 @@
 
 Неотъемлемой частью разработки масштабного приложения служит тестирование тех или иных частей этого приложения.
 Есть даже методика разработки приложений, которая тесно связана с тестированием - разработка через тестирование. Возможно, 
-вы знакомы с ней как <a href="https://en.wikipedia.org/wiki/Test-driven_development" target="_blank">TDD</a>.
+вы знакомы с ней - <a href="https://en.wikipedia.org/wiki/Test-driven_development" target="_blank">Test-driven development (TDD)</a>.
 
 Разработчики и сообщество Yii приложило много усилий, чтобы можно было максимально просто покрыть тестами необходимый код.
 
-Раньше, например когда создавали форму опрос, приходилось открывать браузер, заполнять форму выдуманными данными, проверять
-результат. Добавляли успешный вывод сообщения, в виде результата - опять открывали форму, заполняли данными, проверяли 
-результат. Добавили, поведение к форме - опять проверяли, открывая форму и вводя данные. Сохраняли результат в базе данных - 
-приходилось смотреть сохранились ли данные корректно. Всё это наверное вам знакомо. Возможно, вам приходится такое проделывать,
+Раньше, когда создавали форму опрос, приходилось открывать страницу с формой, заполнять её выдуманными данными, проверять
+результат. Добавляли код для вывода сообщения о успешном результате - опять открывали страницу с формой, заполняли её, проверяли 
+результат. Добавляли поведение к форме - опять проверяли результат, открывая страницу с формой и заполняя её. Сохраняли результат в базе данных - 
+приходилось проверять сохранились ли данные корректно. Возможно, вам приходится такое проделывать каждый раз,
 когда разрабатывается тот или иной функционал. А когда приложение становится масштабным, уже боязно вносить изменения
-в код. Так как далее приходится тратить много времени, чтобы пройтись по некоторым страницам сайта и проверить
-вручную всё ли работает как требуется. И часто, спустя несколько дней, кто-нибудь сообщает, что то что, когда-то работало,
+в код потому, что далее приходится тратить много времени и сил, чтобы пройтись по некоторым страницам сайта и вручную
+проверить, всё ли работает как требуется. И часто, спустя несколько дней, кто-нибудь сообщает, что то что, когда-то работало,
 перестало работать. И опять тратиться время на выяснение причины неисправности, а так как изменения вносились несколько
-дней назад, то поиск истиной причины становится мукой. Или причина неисправности определяется неверно и в результате 
+дней назад, то поиск истиной причины становится мукой. А бывает причина неисправности определяется неверно и в результате 
 добавляется "костыль", который исправляет проблему. 
 
-Может вы к этому привыкли и вас всё устраивает. Но что, если про это всё забыть и использовать всего лишь одну команду:
+Может вы к этому привыкли и вас всё устраивает. Но что, если про это всё забыть и использовать всего лишь одну команду,
+которая выполнит все проверки в самых нежных и уязвимых местах приложения:
 
 ```
 codecept run
@@ -26,17 +27,19 @@ codecept run
 Всё! Больше ничего. Запустив команду, после очередного изменения кода и не увидев ни одной ошибки в результатах, вы можете 
 со спокойной душой сообщить всем, что всё работает, как того требует техническое задание.
 
-В этой главе посмотрим, что скрывается под командой `codecept run`. Чтобы начать, выполните команду из 
-директории yii2-tutorial:
+В этой главе посмотрим, что скрывается под командой `codecept run`. 
+
+Для подготовки кода в соответствии с этой главой, выполните команду из директории yii2-tutorial:
 
 ```
 git checkout -f step-1.0
 ```
 
-
-<p class="alert alert-info">Под Windows вместо стандартной командной строки cmd лучше использовать другой интерпретатор.
-Тот который использует подсветку кода, например <a href="http://gooseberrycreative.com/cmder/" target="_blank">Cmder</a>.
-Если у вас возникли проблемы с кодировкой в командной строке, то попробуйте выполнить в ней команду "chcp 65001".
+<p class="alert alert-info">Работая под Windows вместо стандартной командной строки cmd удобнее использовать другой 
+интерпретатор, который использует подсветку кода. Например <a href="http://www.conemu.ru/" target="_blank">ConEmu</a>, он
+идёт в комплекте с <a href="http://open-server.ru/" target="_blank">OpenServer</a> или 
+<a href="http://gooseberrycreative.com/cmder/" target="_blank">Cmder</a>. Если у вас возникли проблемы с кодировкой 
+в командной строке, то попробуйте выполнить в ней команду "chcp 65001".
 </p>
 
 #### Codeception
@@ -46,7 +49,7 @@ Codeception основан на php фреймворке для тестиров
 Вся настройка Codeception сводится к следующим шагам:
 
 - создайте директорию `codecept`, где посчитаете нужным (не внутри учебника)
-- создайте в этой директории `composer.json`:
+- создайте в этой директории `composer.json` со следующим содержанием:
 ```
 {
     "require": {
@@ -59,7 +62,7 @@ Codeception основан на php фреймворке для тестиров
 - запустите команду `composer install` из этой директории
 - после установки всех зависимостей, настройте переменную 
 <a href="https://ru.wikipedia.org/wiki/PATH_%28%D0%BF%D0%B5%D1%80%D0%B5%D0%BC%D0%B5%D0%BD%D0%BD%D0%B0%D1%8F%29" target="_blank">
-PATH</a> на директории `codecept\vendor\bin\`, чтобы команда codecept была доступна из любого места.
+PATH</a> на директории `codecept\vendor\bin\`, чтобы команда `codecept` была доступна глобально.
 
 Теперь можно выполнить команду `codecept -V`, чтобы увидеть версию Codeception и убедиться, что он успешно установлен.
 
@@ -101,7 +104,7 @@ Codeception поддерживает следующие виды тестов:
 `acceptance, functional, unit` директории, которые хранят тесты в зависимости от их видов. `_output` - это директория, в 
 которую будет попадать результат эмуляции браузера (html код страницы) для функциональных тестов, в случае ошибки.
 
-В Codeception есть понятие "Исполнители тестов". Из названия понятно, для чего они. Для того, чтобы их создать 
+В Codeception есть понятие "Исполнители тестов". Для чего они? Из названия понятно. Перед их созданием 
 необходимо произвести их инициализацию. В директории `tests/codeception/frontend` 
 необходимо выполнить `codecept build`. Создадутся файлы:
 
@@ -142,10 +145,10 @@ OK (6 tests, 49 assertions)
 codecept run functional
 ```
 
-после очередного рефакторинга кода, можно с уверенностью сказать, корректно ли работает сайт. А не бродить по сайту в поисках
-"А не поломал ли я чего-нибудь?". В этом и есть одна из приятных особенностей тестирования.
+после очередного рефакторинга кода, можно с уверенностью сказать, корректно ли работают эти части сайта. Больше не нужно
+бродить по сайту в поисках "А не поломал ли я что-нибудь?". В этом и есть одна из приятных особенностей тестирования.
 
-Также можно попробовать запустить модульные тесты:
+Также можно попробовать запустить модульные(юнит, unit) тесты:
 
 ```php
 codecept run unit
@@ -186,16 +189,23 @@ http://localhost:8888/yii2-app-advanced/. Сделайте это.
 
 А сейчас, когда PhpBrowser настроен, можно пробовать запускать и приёмочные тесты.
 
-Запуск отдельных тестов, сокращает время ожидания выполнения. Codeception поддерживает: запуск всех тестов, 
-запуск тестов по видам и запуск отдельных тестов. Например, для `yii2-app-advanced/tests/codeception/frontend` можно 
-выполнить:
+Запуск отдельных тестов, сокращает время ожидания выполнения. Codeception поддерживает: 
+
+- запуск всех тестов;
+- запуск тестов по видам;
+- запуск отдельных тестов.
+ 
+Например, для `yii2-app-advanced/tests/codeception/frontend` можно выполнить:
 
 ```
 codecept run
 codecept run functional
 codecept run functional functional\InterviewCept.php 
 ```
 
+В разделе [Сохранение реляционных данных](/scripts/index.php?c=step-1.3) присутствует пример как проверить работоспособность
+формы с помощью тестирования.
+
 #### Дополнительная информация для самостоятельного ознакомления:
 
 - <a href="https://ru.wikipedia.org/wiki/%D0%AD%D0%BA%D1%81%D1%82%D1%80%D0%B5%D0%BC%D0%B0%D0%BB%D1%8C%D0%BD%D0%BE%D0%B5_%D0%BF%D1%80%D0%BE%D0%B3%D1%80%D0%B0%D0%BC%D0%BC%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5" target="_blank">Экстремальное программирование</a>.
