Что такое tsdoc-comments?
Используйте при документировании общедоступных API. Используйте при написании кода библиотеки. Используйте при использовании комментариев в стиле JSDoc. Используйте при создании документации. Используйте при объяснении сложных типов. Источник: marius-townhouse/effective-typescript-skills.