3 ms·
The right direction is: more explicit information, more commitment on a stable contract with explicit guarantees, maximize machine readability. The wrong direc
by 29athrowaway 4y ago
The right direction is: more explicit information, more commitment on a stable contract with explicit guarantees, maximize machine readability.
The wrong direction is: less information, no stable contracts, forcing people to guess, complete chaos and anarchy, make up your own format with your own tags that nobody supports.
- allendoerfer 4y agoWe are on the same page, which is why I would advise to use TypeScript instead of JSDoc.
- 29athrowaway 4y agoWhen you can use it, you should. My comparison was between: - JavaScript with no documentation tags - JavaScript with non-machine readable documentation - JavaScript with documentation tags