You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Выделено из зонтичного #219 (замечание Сергея М, 2023). Пункт остаётся актуальным: порядок уроков с тех пор не менялся.
Проблема
Объединение типов (union) вводится в курсе трижды и в неудобном порядке:
10-basics/70-type-aliases — union появляется в примере как рабочий инструмент, с комментарием «union тип из трёх возможных значений», без объяснения;
25-types/10-type-as-sets — union объясняется через теорию множеств;
25-types/20-union-types — отдельный урок про union.
Между первым и вторым уроком лежит половина курса, и union в них используется многократно. Студент сначала много раз применяет конструкцию, а потом дважды подряд читает, что это такое.
Желаемый результат
Студент знакомится с union один раз, до того как начнёт им пользоваться, и дальше уроки на него опираются. Уроки type-as-sets и union-types не пересказывают одно и то же: за первым остаётся модель «тип как множество», за вторым — практика (или они объединяются).
Что нужно решить (поэтому не для агента)
Переносить ли введение union ближе к началу курса — это меняет порядок модулей и URL уроков не затрагивает, но затрагивает прогресс студентов, уже проходящих курс.
Оставить ли type-as-sets как отдельный урок и о чём он тогда: сейчас, по замечанию автора issue, «словно вообще не про то».
Сохранять ли обратную совместимость с внешними ссылками на уроки.
Решение методическое и требует владельца курса. После него сама правка контента уже делегируема.
Acceptance criteria (после принятия решения)
Union объясняется до первого практического применения в курсе
Между уроками про множества и про union нет дублирования содержания
Порядок уроков в модулях согласован с числовыми префиксами директорий
Выделено из зонтичного #219 (замечание Сергея М, 2023). Пункт остаётся актуальным: порядок уроков с тех пор не менялся.
Проблема
Объединение типов (union) вводится в курсе трижды и в неудобном порядке:
10-basics/70-type-aliases— union появляется в примере как рабочий инструмент, с комментарием «union тип из трёх возможных значений», без объяснения;25-types/10-type-as-sets— union объясняется через теорию множеств;25-types/20-union-types— отдельный урок про union.Между первым и вторым уроком лежит половина курса, и union в них используется многократно. Студент сначала много раз применяет конструкцию, а потом дважды подряд читает, что это такое.
Желаемый результат
Студент знакомится с union один раз, до того как начнёт им пользоваться, и дальше уроки на него опираются. Уроки
type-as-setsиunion-typesне пересказывают одно и то же: за первым остаётся модель «тип как множество», за вторым — практика (или они объединяются).Что нужно решить (поэтому не для агента)
type-as-setsкак отдельный урок и о чём он тогда: сейчас, по замечанию автора issue, «словно вообще не про то».Решение методическое и требует владельца курса. После него сама правка контента уже делегируема.
Acceptance criteria (после принятия решения)
make checkпроходитOut of scope
25-typesцеликом