Take me back!

JSDoc is Awesome

Javascript is pretty great, but it has a lot (a lot) of problems. A big problem is type annotations, especially for classes or functions.

In fact, Javascript functions in general are just pretty messed up. The language doesn't care whether you actually pass in parameters and has horrible support for optional params, to name a few common complaints.

Typescript solves a ton of these problems, but it needs to be compiled into JS, and its rules feel a little constricting at times.

That's why I love JSDoc. JSDoc is a pretty good compromise between JS and Typescript. Essentially you can specify type annotations for function and class parameters in vanilla js, by leaving comments to document them. My IDE supports JSDoc, so it has helped a great deal.

Yeah, that's all.