syntactical norms

githubjeka · githubjeka · commit 97e80aca7631 · 2015-07-10T12:04:46.000+03:00
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,8 +27,9 @@ codecept run
 Всё! Больше ничего. Запустив команду, после очередного изменения кода и не увидев ни одной ошибки в результатах, вы можете 
 со спокойной душой сообщить всем, что всё работает, как того требует техническое задание.
 
-В этой главе посмотрим, что скрывается под командой `codecept run`. Чтобы начать, выполните команду из 
-директории yii2-tutorial:
+В этой главе посмотрим, что скрывается под командой `codecept run`. 
+
+Для подготовки кода в соответствии с этой главой, выполните команду из директории yii2-tutorial:
 
 ```
 git checkout -f step-1.0
@@ -47,7 +49,7 @@ Codeception основан на php фреймворке для тестиров
 Вся настройка Codeception сводится к следующим шагам:
 
 - создайте директорию `codecept`, где посчитаете нужным (не внутри учебника)
-- создайте в этой директории `composer.json`:
+- создайте в этой директории `composer.json` со следующим содержанием:
 ```
 {
     "require": {
@@ -60,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 и убедиться, что он успешно установлен.
 
@@ -102,7 +104,7 @@ Codeception поддерживает следующие виды тестов:
 `acceptance, functional, unit` директории, которые хранят тесты в зависимости от их видов. `_output` - это директория, в 
 которую будет попадать результат эмуляции браузера (html код страницы) для функциональных тестов, в случае ошибки.
 
-В Codeception есть понятие "Исполнители тестов". Из названия понятно, для чего они. Для того, чтобы их создать 
+В Codeception есть понятие "Исполнители тестов". Для чего они? Из названия понятно. Перед их созданием 
 необходимо произвести их инициализацию. В директории `tests/codeception/frontend` 
 необходимо выполнить `codecept build`. Создадутся файлы:
 
@@ -143,10 +145,10 @@ OK (6 tests, 49 assertions)
 codecept run functional
 ```
 
-после очередного рефакторинга кода, можно с уверенностью сказать, корректно ли работает сайт. А не бродить по сайту в поисках
-"А не поломал ли я чего-нибудь?". В этом и есть одна из приятных особенностей тестирования.
+после очередного рефакторинга кода, можно с уверенностью сказать, корректно ли работают эти части сайта. Больше не нужно
+бродить по сайту в поисках "А не поломал ли я что-нибудь?". В этом и есть одна из приятных особенностей тестирования.
 
-Также можно попробовать запустить модульные тесты:
+Также можно попробовать запустить модульные(юнит, unit) тесты:
 
 ```php
 codecept run unit
@@ -187,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>.
