Привет, Хабр! Мы рады сообщить, что бета-версия новой редакции TypeScript Handbook вышла из стадии бета-тестирования и теперь является основным ресурсом нашего веб-сайта для изучения TypeScript!

Изучайте справочник в этих форматах: Web / Epub / PDF

В прошлом году команда TypeScript сильно сосредоточилась на увеличении масштабов, современности и объема нашей документации. Одним из наиболее важных разделов нашей документации является справочник, представляющий собой экскурсию по коду TypeScript, который вы встретите в большинстве баз. Мы хотим, чтобы справочник выглядел как первая рекомендация, которую вы используете для изучения TypeScript.

С выпуском обновленного веб-сайта в прошлом году мы включили в справочник некоторые небольшие улучшения, но новая версия справочника - это то, что стало «путеводной звездой» для многих функций нового веб-сайта.

Проект нового справочника стартовал в 2018 году с дополнительным набором ограничений, накладываемых на то, как мы подходим к обучению:

• Оставьте обучение JavaScript экспертам
  
  В Интернете и в книгах есть много отличных ресурсов для изучения JavaScript. Нам не нужно соревноваться в этом пространстве. Справочник призван помочь инженерам понять, как TypeScript строится на базе JavaScript. Эта фокусировка означает, что наша документация может делать предположения о предыстории и избегать объяснения функций JavaScript с нуля.
  
  Это не означает, что мы не ожидаем, что люди с разным уровнем навыков будут использовать это руководство. Например, мы добавили на сайт новый раздел, который знакомит людей с тем, как TypeScript можно сравнивать с другими языками, в зависимости от их технических знаний, в качестве предшественника чтения руководства. Вы можете увидеть это в документации.

• Учите постепенно
  
  Мы хотели строить концепции линейно друг над другом, избегая функций TypeScript, которые еще не были объяснены. Это ограничение заставило нас переосмыслить порядок и категории языковых концепций. Такой способ обучения немного затруднил создание первых нескольких страниц, но он действительно становится ценным для читателей и поощряет стиль чтения от начала до конца.

• Пусть говорит компилятор
  
  Если вы уже использовали документацию TypeScript с момента запуска нового веб-сайта, вы могли заметить, что у нас есть образцы кода, которые предоставляют встроенный контекст, такой как быстрая информация и ошибки, и даже могут отображать выходные файлы .js и .d.ts.
  
  Как участники создания руководства, это означает, что мы должны осознавать, когда изменение TypeScript влияет на документацию. Когда мы переводим веб-сайт на новую версию TypeScript, это также переносится и на руководство, и если результаты не совпадают, нам легко увидеть влияние и понять, какие изменения нам нужно внести.
  
  Что меня восхищает, так это то, что мы используем эти инструменты, чтобы привнести некоторые из лучших функций богатого редактора на страницы в Интернете и статически в файлы epub/pdf для справочника. Эта технология может помочь и вашим приложениям.
  
  Для читателя это означает, что все образцы кода на сайте актуальны, точны и интерактивны.

• Пишите для повседневных кейсов
  
  TypeScript существует уже 8 лет и в целом не удаляет функции. Документирование всех возможных вариантов использования и жизнеспособных вариантов любой концепции было перенесено из сферы ответственности справочника в наш постоянно растущий раздел «справочных страниц». Мы думаем, что это должно устранить отвлекающие факторы на пути к познанию TypeScript.
  
  Хотя для некоторых из нас может быть интересно узнать об истории шаблонов связывания JavaScript или о том, как более эзотерические параметры TypeScript меняют анализ потока кода, большинство людей либо учатся для проектов «с нуля», либо работая в кодовых базах со всем, что уже было изучено.

Эти ограничения помогли нам предоставить более целенаправленную и доступную экскурсию по языку TypeScript. Мы большие поклонники (даже если мы можем быть предвзятыми).

Мы демонстрируем все старые и новые функции, но все они взаимосвязаны и представлены в едином порядке. Никогда не знаешь, что ты мог пропустить. Если вы заметили что-то, что мы упустили, не стесняйтесь оставить нам вопрос на веб-сайте microsoft/TypeScript.