Небольшие правки и дополнения в man 3.1

Author: KaDeaT

manuals/3/0__qa_equivalence_classes/article.md

@@ -1,9 +1,11 @@
 # Классы эквивалентности и граничные значения
 
-Выделение =классов эквивалентности= и анализ =граничных значений= -- два базовых взаимно-дополняющих друг друга подхода для тестирования программ. 
+Выделение =классов эквивалентности= и анализ =граничных значений= -- два базовых взаимно дополняющие друг друга подхода к тестированию программ. 
+
+Давайте разберём их на примере следующей задачи.
 
 > **Задача 1:**
-Подготовить тестове данные для проверки правильности работы программы вычисления модуля целого числа. На вход программе поступает произвольное значение типа `int`.
+Подготовить набор тестовых данных для проверки корректности работы программы вычисления модуля целого числа. На вход программе поступает произвольное значение типа `int`.
 
 Листинг 1. Программа my_abs.c v.0.1
 ```c
@@ -48,13 +50,13 @@ int main(void)
 Тест 2: 25 
 ```
 
-Собственно, уже даже этих тестов хватит, чтобы выявить проблему в нашей программе:
+Уже этих тестов хватает, чтобы выявить проблему в нашей программе -- сценарий для положительных чисел работает неправильно.
 
 ![](./my_abs_test_1.png)
 
-Исправим нашу программу:
+Исправим программу:
 
-Листинг 1. Программа my_abs.c v.0.2
+Листинг 2. Программа my_abs.c v.0.2
 ```c
 #include <stdio.h>
 
@@ -77,12 +79,12 @@ int main(void)
 }
 ```
 
-Теперь программа будет корректно работать на первом наборе тестовых данных.
+Теперь программа будет корректно работать на подготовленном ранее наборе тестовых данных.
 
 
-### Анализ граничных значений
+## Анализ граничных значений
 
-Ошибки в программах очень часто возникают на границах между классами эквивалентности. Поэтому, помимо представителей классов стоит протестировать значения на самой границе и рядом с ней.
+Ошибки в программах очень часто возникают на границах между классами эквивалентности. Поэтому, помимо представителей классов стоит проверить работу программы на самой границе и рядом с ней.
 
 Очевидная граница для нашей задачи -- это значение `0`. 
 
@@ -100,15 +102,15 @@ int main(void)
 
 Чуть менее очевидными являются крайние значения, связанные с ограниченным объёмом типа `int`. 
 
-В моём компиляторе тип `int` занимает `4` байта, а потом минимальное и максимальное значения будут равны `-2147483648` и `2147483647`, соответственно.
+В моём компиляторе тип `int` занимает `4` байта, а потому минимальное и максимальное значения будут равны `-2147483648` и `2147483647`, соответственно. О том, как вычислить эти занчения самостоятельно смотри первое практическое задание [здесь](https://youngcoder.ru/lessons/4/math_function) (другой вариант, где ничего вычислять не требуется, указан в конце урока).
 
 Значит надо дополнить наш набор тестов значениями:
 `-2147483648`, `-2147483647`, `2147483647`, `2147483646`.
 
 Значения `-2147483649` и `2147483648`, находящиеся с другой стороны границ, включать не требуется, т.к. по условию задачи на вход программе поступают лишь значения типа `int`.
 
 
-Дополните тестовый набор указанными значениями и снова запустим проверку программы:
+Дополним тестовый набор указанными значениями и проверим программу на новом тестовом наборе:
 
 ```
 // Справа от теста указан результат проверки
@@ -127,7 +129,7 @@ int main(void)
 Результат работы программ Листинг 2 на шестом тесте:
 ![](./my_abs_test_2.png)
 
-В рамках типа `int` исправить эту проблему не получится, т.к. число `2147483648` превосходит максимальное значение (`INT_MAX` из заголовочного файла `limits.h`), которое может храниться в переменной типа `int`. Поэтому этот случай придётся признать исключительным и аварийно завершить программу:
+В рамках типа `int` исправить эту проблему не получится, т.к. число `2147483648` превосходит максимальное значение, которое может храниться в переменной типа `int`. Поэтому этот случай придётся признать исключительным и аварийно завершить программу:
 
 Листинг 3. Программа my_abs.c v.1.0 
 ```c
@@ -140,7 +142,7 @@ int main(void)
         scanf("%d", &x);
 
         if (x == INT_MIN)
-                return 1;
+                return 1; // завершаем программу с ошибкой
 
         if (x < 0) 
                 abs_x = -x;

manuals/3/0__qa_equivalence_classes/practice.md

@@ -1,2 +1,4 @@
 ## Практика
 **1.** Используя набор тестов, составленных на уроке, протестируйте работу библиотечной функции `abs(x)`.
+
+**2.** Значения `INT_MAX` и `INT_MIN` заданые в заголовочном файле `limits.h`. Найдите его на своём компьютере и посмотрите, чему равны эти значения. Сравните результаты ваших вычислений с этими значениями. Если она не совпадают, значит вы где-то допустили ошибку.