Here are some reasons I like JSDoc: * The syntax is fairly widespread * Documentation pages can be generated from the comment blocks * You can use as little

Here are some reasons I like JSDoc: * The syntax is fairly widespread * Documentation pages can be generated from the comment blocks * You can use as little or as much as you like * Still readable without external tools * Uses block comment syntax I would generally advocate for a mix of JSDoc for public documentation, and type-checking/type-casting functions for actual runtime checks.