I tried to use jsdoc for an old project that was latge and complex. The verbosity killed me from a dx point of view, the amount of crap you have to type especially when dealing with generics just adds even more complexity to the project. I switched to TS and it more than halved the amount of effort required and was CONSIDERABLY better at dealing with generics. And having that extra step for build stage i believe is a worthwhile tradeoff. In my opinion for big projects TS is a more appropriate tool that helps you avoid overdocumenting and keeps your code quite elegant.