{"action":"created","issue":{"url":"https://api.github.com/repos/facebook/flow/issues/3","labels_url":"https://api.github.com/repos/facebook/flow/issues/3/labels{/name}","comments_url":"https://api.github.com/repos/facebook/flow/issues/3/comments","events_url":"https://api.github.com/repos/facebook/flow/issues/3/events","html_url":"https://github.com/facebook/flow/issues/3","id":49276106,"number":3,"title":"Type annotations in comments?","user":{"login":"mhart","id":367936,"avatar_url":"https://avatars.githubusercontent.com/u/367936?v=3","gravatar_id":"","url":"https://api.github.com/users/mhart","html_url":"https://github.com/mhart","followers_url":"https://api.github.com/users/mhart/followers","following_url":"https://api.github.com/users/mhart/following{/other_user}","gists_url":"https://api.github.com/users/mhart/gists{/gist_id}","starred_url":"https://api.github.com/users/mhart/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mhart/subscriptions","organizations_url":"https://api.github.com/users/mhart/orgs","repos_url":"https://api.github.com/users/mhart/repos","events_url":"https://api.github.com/users/mhart/events{/privacy}","received_events_url":"https://api.github.com/users/mhart/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/facebook/flow/labels/feature+request","name":"feature request","color":"d4c5f9"}],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":34,"created_at":"2014-11-18T18:41:06Z","updated_at":"2015-01-04T23:09:34Z","closed_at":null,"body":"Didn't see support for this in the documentation, but it would be great if Flow supported type annotations in comments (or similar) – with the aim of allowing everything to be written in pure JavaScript.\r\n\r\nThis would allow people to keep the same tools they currently use, and skip the transpilation step.\r\n\r\nHas this idea been floated at all? Is it doable?\r\n\r\n*Edit:*\r\n[Looks like this is doable](https://github.com/facebook/flow/blob/master/tests/docblock/docblock.js) – perhaps the documentation just needs to be updated to expound on this?\r\n*Edit again:*\r\nOK, so atm it's just conversion from docblock to flow – would be great if it could be done in-place... or something"},"comment":{"url":"https://api.github.com/repos/facebook/flow/issues/comments/68654007","html_url":"https://github.com/facebook/flow/issues/3#issuecomment-68654007","issue_url":"https://api.github.com/repos/facebook/flow/issues/3","id":68654007,"user":{"login":"misterspeaker","id":8048957,"avatar_url":"https://avatars.githubusercontent.com/u/8048957?v=3","gravatar_id":"","url":"https://api.github.com/users/misterspeaker","html_url":"https://github.com/misterspeaker","followers_url":"https://api.github.com/users/misterspeaker/followers","following_url":"https://api.github.com/users/misterspeaker/following{/other_user}","gists_url":"https://api.github.com/users/misterspeaker/gists{/gist_id}","starred_url":"https://api.github.com/users/misterspeaker/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/misterspeaker/subscriptions","organizations_url":"https://api.github.com/users/misterspeaker/orgs","repos_url":"https://api.github.com/users/misterspeaker/repos","events_url":"https://api.github.com/users/misterspeaker/events{/privacy}","received_events_url":"https://api.github.com/users/misterspeaker/received_events","type":"User","site_admin":false},"created_at":"2015-01-04T23:09:34Z","updated_at":"2015-01-04T23:09:34Z","body":"+1 for me too. Is anyone actually working on this? I don't want an \"almost-js -> real js\" transpile step in my personal projects, so I'd be keen to follow along/help out."}}