{"action":"created","issue":{"url":"https://api.github.com/repos/HaxeFoundation/Project-Management/issues/47","labels_url":"https://api.github.com/repos/HaxeFoundation/Project-Management/issues/47/labels{/name}","comments_url":"https://api.github.com/repos/HaxeFoundation/Project-Management/issues/47/comments","events_url":"https://api.github.com/repos/HaxeFoundation/Project-Management/issues/47/events","html_url":"https://github.com/HaxeFoundation/Project-Management/issues/47","id":125174151,"number":47,"title":"Documenting Design Decision","user":{"login":"Merelleya","id":5541210,"avatar_url":"https://avatars.githubusercontent.com/u/5541210?v=3","gravatar_id":"","url":"https://api.github.com/users/Merelleya","html_url":"https://github.com/Merelleya","followers_url":"https://api.github.com/users/Merelleya/followers","following_url":"https://api.github.com/users/Merelleya/following{/other_user}","gists_url":"https://api.github.com/users/Merelleya/gists{/gist_id}","starred_url":"https://api.github.com/users/Merelleya/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/Merelleya/subscriptions","organizations_url":"https://api.github.com/users/Merelleya/orgs","repos_url":"https://api.github.com/users/Merelleya/repos","events_url":"https://api.github.com/users/Merelleya/events{/privacy}","received_events_url":"https://api.github.com/users/Merelleya/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/HaxeFoundation/Project-Management/labels/In%20Progress","name":"In Progress","color":"bfe5bf"}],"state":"open","locked":false,"assignee":{"login":"Merelleya","id":5541210,"avatar_url":"https://avatars.githubusercontent.com/u/5541210?v=3","gravatar_id":"","url":"https://api.github.com/users/Merelleya","html_url":"https://github.com/Merelleya","followers_url":"https://api.github.com/users/Merelleya/followers","following_url":"https://api.github.com/users/Merelleya/following{/other_user}","gists_url":"https://api.github.com/users/Merelleya/gists{/gist_id}","starred_url":"https://api.github.com/users/Merelleya/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/Merelleya/subscriptions","organizations_url":"https://api.github.com/users/Merelleya/orgs","repos_url":"https://api.github.com/users/Merelleya/repos","events_url":"https://api.github.com/users/Merelleya/events{/privacy}","received_events_url":"https://api.github.com/users/Merelleya/received_events","type":"User","site_admin":false},"milestone":null,"comments":6,"created_at":"2016-01-06T13:13:03Z","updated_at":"2016-01-14T20:55:35Z","closed_at":null,"body":"@nadako in #12\n\n>> adding this https://www.youtube.com/watch?v=-F-3E8pyjFo&feature=youtu.be&a \n\n>Sorry, I'm not following this thread, but I liked that video, especially the part about documenting design decisions, so people can point/be pointed to some issue/post/comment to find out/remember why something was (not) made the way it's done. A couple of months ago I started collecting haxe-related links here https://github.com/nadako/awesome-haxe and it has this `Language design` section. Perhaps we could have a document on haxe.org containing a list of design decisions along with rationale behind them. That way future discussions can be much more reasonable, IMO."},"comment":{"url":"https://api.github.com/repos/HaxeFoundation/Project-Management/issues/comments/171777024","html_url":"https://github.com/HaxeFoundation/Project-Management/issues/47#issuecomment-171777024","issue_url":"https://api.github.com/repos/HaxeFoundation/Project-Management/issues/47","id":171777024,"user":{"login":"ncannasse","id":1022912,"avatar_url":"https://avatars.githubusercontent.com/u/1022912?v=3","gravatar_id":"","url":"https://api.github.com/users/ncannasse","html_url":"https://github.com/ncannasse","followers_url":"https://api.github.com/users/ncannasse/followers","following_url":"https://api.github.com/users/ncannasse/following{/other_user}","gists_url":"https://api.github.com/users/ncannasse/gists{/gist_id}","starred_url":"https://api.github.com/users/ncannasse/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ncannasse/subscriptions","organizations_url":"https://api.github.com/users/ncannasse/orgs","repos_url":"https://api.github.com/users/ncannasse/repos","events_url":"https://api.github.com/users/ncannasse/events{/privacy}","received_events_url":"https://api.github.com/users/ncannasse/received_events","type":"User","site_admin":false},"created_at":"2016-01-14T20:55:35Z","updated_at":"2016-01-14T20:55:35Z","body":"If you want to write some words about it (longer and better explained / more diplomatic than my quick rant) we can publish this as a blog post once we have our blog ready, then link the post from the manual documentation."}}