{"action":"created","issue":{"url":"https://api.github.com/repos/dart-lang/sdk/issues/23944","labels_url":"https://api.github.com/repos/dart-lang/sdk/issues/23944/labels{/name}","comments_url":"https://api.github.com/repos/dart-lang/sdk/issues/23944/comments","events_url":"https://api.github.com/repos/dart-lang/sdk/issues/23944/events","html_url":"https://github.com/dart-lang/sdk/issues/23944","id":98645369,"number":23944,"title":"provide dartdoc documentation for all dart keywords","user":{"login":"kasperpeulen","id":1035299,"avatar_url":"https://avatars.githubusercontent.com/u/1035299?v=3","gravatar_id":"","url":"https://api.github.com/users/kasperpeulen","html_url":"https://github.com/kasperpeulen","followers_url":"https://api.github.com/users/kasperpeulen/followers","following_url":"https://api.github.com/users/kasperpeulen/following{/other_user}","gists_url":"https://api.github.com/users/kasperpeulen/gists{/gist_id}","starred_url":"https://api.github.com/users/kasperpeulen/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/kasperpeulen/subscriptions","organizations_url":"https://api.github.com/users/kasperpeulen/orgs","repos_url":"https://api.github.com/users/kasperpeulen/repos","events_url":"https://api.github.com/users/kasperpeulen/events{/privacy}","received_events_url":"https://api.github.com/users/kasperpeulen/received_events","type":"User","site_admin":false},"labels":[],"state":"closed","locked":false,"assignee":null,"milestone":null,"comments":3,"created_at":"2015-08-02T23:37:11Z","updated_at":"2015-08-03T16:37:07Z","closed_at":"2015-08-03T16:27:01Z","body":"tagging @sethladd @lukechurch @kwalrath @Sfshaza \r\n\r\nI think I already talked about this with lukechurch at some point. But I would really love to see dartdoc information for all dart keywords. I mean things like async, await, for, if, void, null etc.\r\n\r\nOne of the things I love about dart, is being able to explore libraries by pressing F1 in webstorm, or just clicking on it in dartpad (or now also at dartlang.org with embedded dartpads, awesome :D)\r\n\r\nBut why not also let users learn the fundamentals of dart in this same manner ? For example, I was exploring some code that uses `await for`, and I haven't used that keyword before. So just by automatism, if I don't understand some code, I press F1 in webstorm, to see if there is more information.\r\n\r\nOf course, in this case, I won't get any extra information, but I think I should. Maybe just some brieve description. Possible linking to this excellent article: https://www.dartlang.org/docs/tutorials/streams/ ?\r\n\r\nWhat do you guys/girls think of that ?"},"comment":{"url":"https://api.github.com/repos/dart-lang/sdk/issues/comments/127320124","html_url":"https://github.com/dart-lang/sdk/issues/23944#issuecomment-127320124","issue_url":"https://api.github.com/repos/dart-lang/sdk/issues/23944","id":127320124,"user":{"login":"sethladd","id":5479,"avatar_url":"https://avatars.githubusercontent.com/u/5479?v=3","gravatar_id":"","url":"https://api.github.com/users/sethladd","html_url":"https://github.com/sethladd","followers_url":"https://api.github.com/users/sethladd/followers","following_url":"https://api.github.com/users/sethladd/following{/other_user}","gists_url":"https://api.github.com/users/sethladd/gists{/gist_id}","starred_url":"https://api.github.com/users/sethladd/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/sethladd/subscriptions","organizations_url":"https://api.github.com/users/sethladd/orgs","repos_url":"https://api.github.com/users/sethladd/repos","events_url":"https://api.github.com/users/sethladd/events{/privacy}","received_events_url":"https://api.github.com/users/sethladd/received_events","type":"User","site_admin":false},"created_at":"2015-08-03T16:37:07Z","updated_at":"2015-08-03T16:37:07Z","body":"> I was thinking about solving this issue at the level of the analyzer.\r\n\r\nI believe the analyzer team is working on a plugin infrastructure. This might be a great plugin."}}