Skip to content

docs(ru): свести теорию с копией курса на Хекслете - #365

Merged
mokevnin merged 1 commit into
mainfrom
docs/merge-hexlet-copies
Aug 14, 2026
Merged

docs(ru): свести теорию с копией курса на Хекслете#365
mokevnin merged 1 commit into
mainfrom
docs/merge-hexlet-copies

Conversation

@mokevnin

Copy link
Copy Markdown
Contributor

Теория этих уроков живет в двух местах: здесь и в курсах Хекслета typescript_basics_course и typescript_advanced_course. Копии расходились независимо друг от друга, и на момент сверки разошлись все 54 пары уроков локали ru.

Сведение поурочное: по каждому уроку брался лучший вариант, а не одна сторона целиком.

Что пришло с Хекслета

  • раздел «Зачем нужны перечисления» в 60-enums
  • вдвое более полный урок 15-object (пример с Object.entries/fromEntries)
  • coll.at(-1) вместо ручной индексации в 30-generic-functions
  • точные формулировки там, где здесь были неточности

Что осталось отсюда и уехало на Хекслет

  • «Защитники типа (Type Guard)» в 90-type-narrowing плюс исправление про перегрузку функций
  • «Создание массива нужной длины» в 25-multi-dimensional-arrays
  • объяснение satisfies в 20-index-signatures
  • «Импорт типов» и «Пространство имен» в 90-modules
  • «Что такое интерфейс» и «Когда использовать интерфейсы» в 10-interfaces-overview
  • подводки к примерам кода, которых на Хекслете не было

Ошибки, вскрывшиеся при сверке

  • function do(...)do это ключевое слово, пример не компилируется
  • numbers.push('hexlet') там, где по смыслу strings.push
  • courses: [string] вместо string[]
  • postgre вместо postgres
  • «В заключении», «Такое поведения», «промисифцировать»

На что обратить внимание при ревью

Убраны 30 TODO-комментариев автору. Почти все просили описание кода, и это описание теперь на месте. Но два в 20-generic-types были другими: просьба разбить длинный текст подзаголовками и заметка о вопросе студентов в топиках. Заголовки я не расставлял, пометки удалил — скажи, если их нужно вернуть.

Код в блоках не переформатирован: здесь стиль задает biome с quoteStyle: single, а прогон mdsf в ките привел бы его к двойным кавычкам.

Парная правка на стороне Хекслета едет отдельными merge request'ами в typescript_basics_course и typescript_advanced_course.

Теория этих уроков живет в двух местах: здесь и в курсах Хекслета
typescript_basics_course и typescript_advanced_course. Копии расходились
годами независимо друг от друга, и разошлись все 54 пары уроков.

Сведение поурочное, а не выбором одной стороны: из копии Хекслета взято
то, чего не хватало здесь, формулировки выбраны точнее.

Заодно исправлены ошибки, которые вскрылись при сверке: `function do()`
в примере (do это ключевое слово), `numbers.push` вместо `strings.push`,
`courses: [string]` вместо `string[]`, `postgre` вместо `postgres`.

Убраны TODO-комментарии автору: описания, которых они просили, теперь на
месте.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@mokevnin
mokevnin requested a review from fey August 14, 2026 16:33
@mokevnin
mokevnin merged commit 70d1467 into main Aug 14, 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