Кстати, VSCode неплохо заточен на интеграцию со связкой typescript/JSDoc.
К примеру, достаточно plain-text описания над каждым полем интерфейса( тип/енам тоже сойдут) *.ts в комментарии произвольной длины


/** это описание интерфейса */
interface SomeInterface {
/** это описание поля интерфейса */
someInterfaceField1: FieldType
/** это описание еще одного поля интерфейса */
someInterfaceField2: FieldType
}


чтобы они вылезали в подсказках VSCode.

Аналогично работает описание входных параметров и выходов функции в JSDoc, которое тоже переходит в подробную подсказку.