We can document internals with this sort of thing, and it will be picked up by IDEs: https://github.com/cjthompson/typescript-examples/blob/master/src/%40types/dir-obj/index.d.ts

... also has the benefit of preparing us for TypeScript.

There's a generator to read jsdoc and generate an initial .d.ts file