13
eo2875
4y

You have a JavaScript application. You have to keep up with stupid devs that don't know TypeScript because you don't have the time to let them study it and they get demotivated when they can't do stuff so fine, you keep it JS. You use JSDoc to write the documentation. You miss using TypeScript so you start doing some @typedef's. Oh your linter gets it and starts behaving as a substitute of TypeScript. You get excited and write more and more @typedef's! ... until they get so complicated that you start documenting *that*...

Comments
  • 1
    Been there. Nobody will give you a cookie for complete docs on *that*. Instead, you'll do just great if discipline in the team is not a phony.
  • 0
    Then you get some shithead working on the codebase while you're off and doesn't annotate anything, someone else approves the PR and he's fucked it all up
  • 0
    good times!
Add Comment