News for hackers. Stuff that matters.
Re:Announcing TypeScript 2.2 by insin on Wednesday February 22, 2017 @06:19PM (#13710203)
I'd prefer that approach too, as I can also document things at the same time as providing type annotations; flow-jsdoc looks interesting, but I don't know how easy it would be to plug into a Babel/Webpack+Babel workflow:

https://github.com/Kegsay/flow-jsdoc

Re:Announcing TypeScript 2.2 by damncabbage on Wednesday February 22, 2017 @08:04PM (#13710766)
There's also comments support in Flow directly, but it's sadly (but understandably) hideous:

  function somefunction(somestring/*: string*/)/*: boolean */ {
     var ret/*: boolean */;
     ...
     return ret;
  }
(See https://flowtype.org/blog/2015/02/20/Flow-Comments.html)
Re:Announcing TypeScript 2.2 by Lio on Thursday February 23, 2017 @05:31AM (#13712880)
Might be worth pointing out, the "documentation" package[1] can be used to generate jsdoc annotations suitable for Google Closure compiler from Flow type annotations.

It can also build really nice HTML documentation to.

[1] https://www.npmjs.com/package/documentation