Я склонен использовать JSDocs в качестве временного промежутка, прежде чем переключаться на Typescript, чтобы обеспечить лучшую информацию о вводе типа для моей IDE. В противном случае просто используйте JSDocs, когда вам нужна дополнительная информация о том, над чем вы работаете, будь то атрибуция в случае использования чужого кода или лучшее описание, которое можно отобразить при наведении курсора на редактор.