3 ms·
Looking back and forth between code and docs just to remember the shape of returned objects is annoying and probably the worst for productivity. I imagine most
by FLUX-YOU 9y ago
Looking back and forth between code and docs just to remember the shape of returned objects is annoying and probably the worst for productivity.
I imagine most people using vanilla JS have significant amounts of objects memorized.
- speg 9y agoIF there any docs!
- zdragnar 9y agoIDEs like webstorm can ostensibly be quite helpful if you use jsdoc style annotations. However, in my experience, once a code base is big enough, you can open almost any file and find documentation that's out of date, incorrectly copy-pasted, or some other major issue. TS, on the other hand, at least forces you to stay correct, which is ultimately what convinced me to switch.
- nothrabannosir 9y ago> jsdoc style annotations Which are a form of type annotations. Case in point: the typescript compiler can actually parse those, in .js files, and yield appropriate warnings on errors. See the //@ts-check annotation.
- zdragnar 9y agoIt'd be a lot less effort to just use TS imho.
- zdragnar 9y agoEdit: I meant jsdoc-style, not "style annotations".