Skip to content

FEEDBACK-443: вернуть неаккуратные примеры в урок и задание про линтер - #382

Merged
fey merged 1 commit into
mainfrom
feedback-443-broken-examples
Sep 11, 2026
Merged

FEEDBACK-443: вернуть неаккуратные примеры в урок и задание про линтер#382
fey merged 1 commit into
mainfrom
feedback-443-broken-examples

Conversation

@fey

@fey fey commented Sep 11, 2026

Copy link
Copy Markdown
Contributor

Парная правка к PR в exercises-javascript (#867) и exercises-php (#399), а также к правкам курсов Хекслета python_fundamentals в ru и es. Тикет FEEDBACK-443.

Что случилось

Прогон make lint-code-blocks-fix (кампания mdsf-code-blocks в ките) привёл к стилю оба блока.

README — под «Рассмотрим пример» лежал неаккуратный код, а ниже объяснение, что линтер укажет на нехватку пробела:

-result = 1+ 3
+result = 1 + 3

Указывать стало не на что. Ascii-схема ниже при этом всё ещё показывает 1+ 3 — она в блоке text, и прогон её не тронул, поэтому урок противоречит сам себе.

EXERCISE — задание стало невыполнимым. Условие просит «исправьте пробелы вокруг операторов», а код под ним уже исправлен:

-print(    (5  **2)-(3*  7))
+print((5**2) - (3 * 7))

Снаружи ничего не видно: markdown валиден, линтеры молчат, lint-code-blocks зелёный по построению — форматтер сам это и сделал.

Что в правке

Неаккуратные версии возвращены во всех трёх локалях, блоки переведены на метку text и помечены:

<!-- lint-code-blocks: skip — неаккуратный код это предмет урока, форматтер привёл бы его к стилю -->

Правило закреплено в ките (docs/markdown.md, § «Антипример идёт в ```text»), список дыр в проверке собирается грепом по этой строке. Цена — блок теряет подсветку; размен сознательный, разобран в docs/mdsf-code-blocks.md.

Проза не менялась: правка целиком внутри блоков кода.

🤖 Generated with Claude Code

Прогон форматтера привёл к стилю оба блока урока, и он показывал одинаковый код
там, где текст обещает разницу между неаккуратным и аккуратным вариантом.

В задании вышло хуже: условие просит исправить пробелы вокруг операторов, а код
под ним прогон уже исправил. Выполнить такое задание нельзя.

Неаккуратные версии возвращены во всех трёх локалях, блоки помечены как
антипримеры (`docs/markdown.md` кита, § «Антипример идёт в ```text»).

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@fey
fey merged commit 9050be4 into main Sep 11, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant