improve content

Signed-off-by: Kirill Mokevnin <[email protected]>

Author: mokevnin

modules/10-basics/20-comments/ru/README.md

@@ -31,3 +31,23 @@ print('I am the King')
 Они не влияют на выполнение программы, но делают код понятнее. Комментарии помогают команде быстрее разобраться в чужом коде и не забыть важные детали в собственном.
 
 > 📌 Хорошее правило: пишите код так, чтобы он был понятен без комментариев, но если что-то требует пояснения — не стесняйтесь комментировать.
+
+## Служебные комментарии
+
+В процессе работы вы будете встречаться с таким кодом в нашем редакторе:
+
+```python
+# BEGIN
+
+# END
+```
+
+*BEGIN* и *END* здесь это обычные комментарии, которые никак не влияют на работу программы. Они нужны для того, чтобы показать место, где нужно писать код задания - между ними.
+
+```python
+# BEGIN
+<здесь ваше решение>
+# END
+```
+
+Проще говоря: видите *BEGIN* и *END* — пишите между ними, остальное не трогайте.

modules/10-basics/40-testing/en/EXERCISE.md

@@ -1 +1 @@
-Display `9780262531962`.
+Display `10`.

modules/10-basics/40-testing/es/EXERCISE.md

@@ -1 +1 @@
-Muestra en la pantalla `9780262531962`.
+Muestra en la pantalla `10`.

modules/10-basics/40-testing/index.py

@@ -1 +1 @@
-print("9780262531962")
+print(10)

modules/10-basics/40-testing/ru/EXERCISE.md

@@ -1 +1 @@
-Выведите на экран `9780262531962` используя `print()`.
+Выведите на экран число 10 по примеру из теории. Проверьте как работает система тестирования, попробуйте вывести что-нибудь другое и посмотрите на вывод. Это поможет научиться его распознавать и правильно анализировать.

modules/10-basics/40-testing/ru/README.md

@@ -1,26 +1,29 @@
 Наш сайт автоматически проверяет ваши решения. Как это работает?
 
-В самом простом случае система просто запускает ваш код и смотрит на то, что вывелось на экран. А потом сверяет с тем, что мы «ожидали» по заданию.
+В самом простом случае система просто запускает ваш код и смотрит на то, что вывелось на экран. А потом сверяет с тем, что мы «ожидали» по заданию. Например, если задание звучит так: «Выведите число 10 на экран», то ваш код на Python может выглядеть так:
 
-В следующих, более сложных уроках вы будете писать функции — некие мини-программы, принимающие информацию из внешнего мира и производящие какие-то операции. Проверка ваших решений в таких случаях выглядит немного сложнее: система запускает ваше решение и передаёт какую-то информацию. Система также знает — «ожидает» — какой именно ответ должна дать правильная функция при таких входных данных.
+```python
+print(10)
+```
 
-Например, если ваша задача — написать функцию сложения двух чисел, то проверочная система будет передавать ей разные комбинации чисел и сверять ответ вашей функции с реальными суммами. Если во всех случаях ответы совпадут, то решение считается верным.
+Система запустит его и проверит, что на экране действительно появилось 10. Если совпало с ожидаемым результатом — решение будет зачтено, если нет, то вы увидите ошибку:
 
-Такой подход называется тестированием, и он используется в реальной повседневной разработке. Обычно программист сначала пишет тест — проверочную программу, а потом уже ту программу, которую хотел написать. В процессе он постоянно запускает тесты и смотрит, приблизился ли он к решению.
-
-Именно поэтому наш сайт говорит «Тесты пройдены», когда вы правильно решили задачу.
+```bash
+E   AssertionError: assert '9' == '10'
+E
+E     - 10
+E     + 9
+```
 
-Вот простой пример: в одном из будущих уроков вам нужно будет написать функцию, которая производит вычисления и выдаёт ответ. Допустим, вы допустили небольшую ошибку, и функция выдала неправильное число. Система ответит примерно так:
+Плюсом показан результат работы вашего кода, минусом ожидаемое значение, которое тест хотел увидеть, но не увидел.
 
-```text
-AssertionError: '10' != '35'
-```
+В следующих, более сложных уроках вы будете писать функции — мини-программы, принимающие информацию из внешнего мира и производящие какие-то операции. Проверка ваших решений в таких случаях выглядит немного сложнее: система запускает ваше решение и передаёт какую-то информацию. Система также знает — «ожидает» — какой именно ответ должна дать правильная функция при таких входных данных.
 
-Самое главное начинается после двоеточия: «значение "10" не равно ожидаемому значению "35"». То есть правильная функция должна была выдать 35, но текущее решение работает неправильно и выдаёт 10.
+Например, если ваша задача — написать функцию сложения двух чисел, то проверочная система будет передавать ей разные комбинации чисел и сверять ответ вашей функции с реальными суммами. Если во всех случаях ответы совпадут, то решение считается верным.
 
-Если в редакторе уже есть какой-то код, окружённый комментариями *BEGIN* и *END*, это означает, что свой код нужно писать строго между ними. Код за пределами этих комментариев менять не стоит — это может повлиять на корректность проверки.
+Такой подход называется тестированием, и он используется в реальной повседневной разработке. Обычно программист сначала пишет тест — проверочную программу, а потом уже ту программу, которую хотел написать. В процессе он постоянно запускает тесты и смотрит, приблизился ли он к решению.
 
-Проще говоря: видите *BEGIN* и *END* — пишите между ними, остальное не трогайте.
+Именно поэтому наш сайт говорит «Тесты пройдены», когда вы правильно решили задачу.
 
 ## Моя ошибка или нет?
 

modules/10-basics/40-testing/test_code.py

@@ -2,5 +2,5 @@
 
 
 def test(capsys):
-    expected = "9780262531962"
+    expected = "10"
     expect_output(capsys, expected)