Решение модуля: возможная устаревшая документация по TypeScript

Я только что прочитал эту статью о разрешении модулей в документации по TypeScript.

Я считаю, что это уже не может быть всей историей, как указано в разделе «@types, typeRoots и типы» в документацию tsconfig.json, файлы определения типов также берутся из каталога node_modules/@types.

Об этой функции также было объявлено здесь и объясняется несколько здесь.

Я пишу этот вопрос на SO, чтобы люди могли подтвердить, что у меня есть это право, и отчет об ошибке документации для парней TypeScript (руководство по подаче заявок на GitHub меня отпугнуло).

Итак, правильно ли я думаю, что связанный фрагмент документации неполный?


person John    schedule 27.11.2016    source источник
comment
в чем именно вопрос?   -  person toskv    schedule 27.11.2016
comment
@toskv Добавлено предложение, заканчивающееся знаком вопроса.   -  person John    schedule 27.11.2016


Ответы (1)


Я думаю ты прав. Чтобы быть более уверенным (для этого или вообще), я обычно смотрю на история самих документов разрешения модуля. Недавно у них было довольно много небольших обновлений, но в остальном последним крупным коммитом было добавление изменений в поведение из TypeScript 1.8, еще в марте, задолго до этих изменений 2.0. Немного больше информации об этих изменениях можно найти в разделе «Файлы объявлений» > «Потребление» (https://www.typescriptlang.org/docs/handbook/declaration-files/consumment.html), но он в основном ориентирован на случай конечного пользователя, а не документирует, как именно tsc находит определения этих типов. потом.

На вашем месте я бы открыл ошибку в репозитории TypeScript-Handbook и начал процесс обновления. Честно говоря, все это говорит мне о том, что сейчас не так много времени на изучение этой части документации - будьте готовы, что наиболее эффективным способом обновления этого может быть составление плана этого самостоятельно, и чтобы затем попросить помочь проверить его и заполнить детали.

person Tim Perry    schedule 28.11.2016
comment
Спасибо, я по крайней мере зарегистрирую билет. - person John; 28.11.2016