Переписать вводный урок «TypeScript как второй язык»: порядок изложения и блок про установку

[fey]

This was generated by AI during triage.

Выделено из зонтичного #219 (замечание Сергея М, 2023). Относится к уроку 10-basics/20-typescript-as-a-second-language.

Проблема

Три конкретные претензии к тексту вводного урока, все три сохраняются:

1. Порядок изложения. Сначала вводятся две группы языков, затем сразу говорится, что преимущества TypeScript возникают из-за принадлежности JavaScript к первой группе, потом объясняется первая группа, потом блоки кода, и только потом возвращение ко второй. Читатель прыгает по тексту вверх-вниз. Предложенный автором issue порядок: две группы → JavaScript динамический, что это значит → плюсы и минусы → TypeScript статический, что это значит → плюсы и минусы.
2. Немотивированный переход. Фраза про «большие команды в десятки и сотни разработчиков» во фронтенде появляется без подготовки — до неё речь не шла ни о фронтенде, ни о размере команд.
3. Блок про установку. Текст обещает «более простой способ», чем установка TypeScript, а на деле описывает ts-node — способ не устанавливать, а запускать без отдельной компиляции. Обещание и содержание расходятся.

Желаемый результат

Вводный урок читается линейно: каждый термин вводится до его использования, переходы мотивированы, а блок про инструменты честно называет, что чем является (компилятор tsc против запуска через ts-node).

Почему не для агента

Это переписывание теории вводного урока — самого читаемого в курсе. Нужна авторская интонация и редакторское решение о глубине (сколько говорить про плюсы/минусы динамической типизации на первом уроке). Механическая правка тут даст «текст, в котором всё верно, но никто не хочет читать».

Acceptance criteria

• Терминов, используемых раньше, чем они введены, в уроке нет
• Абзац про фронтенд-команды либо подготовлен предшествующим контекстом, либо убран
• Блок про инструменты не называет ts-node «более простым способом установки»
• ru- и en-версии синхронны по структуре
• Полный make check проходит

Out of scope

• Другие уроки модуля 10-basics
• Остальные пункты Обработать замечания #219 (разнесены отдельно или уже исправлены)

[fey]

Проверка на текущем main: ни одна из трёх претензий не воспроизводится

Триаж 2026-08-05 сказал «все три сохраняются», но это не так — все три относятся к тексту урока образца 2023 года, а урок с тех пор переписан. Файл modules/10-basics/20-typescript-as-a-second-language/{ru,en}/README.md последний раз менялся 2025-08-13 (964dd43), то есть за год до триажа, и уже в том виде, что сейчас.

1. Порядок изложения. Требуемый в issue порядок — «две группы → JavaScript динамический → плюсы и минусы → TypeScript статический → плюсы и минусы». Текущий текст идёт ровно так: раздел «Что такое TypeScript» называет обе группы одной фразой, дальше объясняет динамическую типизацию на JavaScript (интерпретатор + пример с BigInt), дальше статическую на TypeScript (список преимуществ + тот же пример) и заканчивает тем, что однозначно лучшего подхода нет. Прыжков вверх-вниз нет.

2. Абзац про фронтенд-команды. Отсутствует:

$ grep -rn "десятк\|сотни разработчиков\|фронтенд" modules/10-basics/20-typescript-as-a-second-language/
$ echo $?
1

3. Блок про установку. Обещания «более простого способа» в тексте нет. Раздел говорит «установка TypeScript предельно простая», показывает npm install typescript, npx tsc index.ts, node index.js, и отдельным абзацем называет ts-node пакетом, «который выполняет одновременно компиляцию и запуск» и даёт REPL. Это ровно то, чем ts-node является — расхождения обещания и содержания нет.

Acceptance criteria issue при этом выполнены на текущем тексте: терминов раньше их введения нет, абзаца про фронтенд-команды нет, ts-node не назван способом установки, ru и en синхронны по структуре.

Предложение

Закрыть как неактуальный. Если претензия к вводному уроку остаётся, её стоит переформулировать по нынешнему тексту: старые формулировки к нему не привязываются, и работать по ним значит искать то, чего нет.

Побочный вывод для остальных выделенных из #219: они собраны по замечаниям 2023 года, а курс с тех пор правился. Прежде чем брать такой issue в работу, стоит сверить претензию с текущим файлом — здесь на это ушло пять минут.