{"action":"created","issue":{"url":"https://api.github.com/repos/jquery/api.jquery.com/issues/625","labels_url":"https://api.github.com/repos/jquery/api.jquery.com/issues/625/labels{/name}","comments_url":"https://api.github.com/repos/jquery/api.jquery.com/issues/625/comments","events_url":"https://api.github.com/repos/jquery/api.jquery.com/issues/625/events","html_url":"https://github.com/jquery/api.jquery.com/pull/625","id":54472936,"number":625,"title":"Refer to jQuery.Deferred as a factory rather than a constructor.","user":{"login":"ChadKillingsworth","id":1247639,"avatar_url":"https://avatars.githubusercontent.com/u/1247639?v=3","gravatar_id":"","url":"https://api.github.com/users/ChadKillingsworth","html_url":"https://github.com/ChadKillingsworth","followers_url":"https://api.github.com/users/ChadKillingsworth/followers","following_url":"https://api.github.com/users/ChadKillingsworth/following{/other_user}","gists_url":"https://api.github.com/users/ChadKillingsworth/gists{/gist_id}","starred_url":"https://api.github.com/users/ChadKillingsworth/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ChadKillingsworth/subscriptions","organizations_url":"https://api.github.com/users/ChadKillingsworth/orgs","repos_url":"https://api.github.com/users/ChadKillingsworth/repos","events_url":"https://api.github.com/users/ChadKillingsworth/events{/privacy}","received_events_url":"https://api.github.com/users/ChadKillingsworth/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":4,"created_at":"2015-01-15T16:50:38Z","updated_at":"2015-03-07T13:53:06Z","closed_at":null,"pull_request":{"url":"https://api.github.com/repos/jquery/api.jquery.com/pulls/625","html_url":"https://github.com/jquery/api.jquery.com/pull/625","diff_url":"https://github.com/jquery/api.jquery.com/pull/625.diff","patch_url":"https://github.com/jquery/api.jquery.com/pull/625.patch"},"body":"The `jQuery.Deferred` description describes it as a constructor. This is misleading. The returned object fails the following checks:\r\n\r\n```JavaScript\r\n(new jQuery.Deferred()) instanceof jQuery.Deferred === true //this is false\r\njQuery.Deferred() instanceof jQuery.Deferred === true //this is false\r\n```\r\n\r\nAlso, extending the prototype (inheriting) from the jQuery.Deferred method would not produce the expected results. (it would infact do nothing useful).\r\n\r\nThis update describes the method as a factory which returns a new `deferred` object which is consistent with the rest of the api site documentation.\r\n\r\nFor more info, see google/closure-compiler#767\r\n\r\nI should have a CLA on file - if not, let me know."},"comment":{"url":"https://api.github.com/repos/jquery/api.jquery.com/issues/comments/77690083","html_url":"https://github.com/jquery/api.jquery.com/pull/625#issuecomment-77690083","issue_url":"https://api.github.com/repos/jquery/api.jquery.com/issues/625","id":77690083,"user":{"login":"timmywil","id":192451,"avatar_url":"https://avatars.githubusercontent.com/u/192451?v=3","gravatar_id":"","url":"https://api.github.com/users/timmywil","html_url":"https://github.com/timmywil","followers_url":"https://api.github.com/users/timmywil/followers","following_url":"https://api.github.com/users/timmywil/following{/other_user}","gists_url":"https://api.github.com/users/timmywil/gists{/gist_id}","starred_url":"https://api.github.com/users/timmywil/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/timmywil/subscriptions","organizations_url":"https://api.github.com/users/timmywil/orgs","repos_url":"https://api.github.com/users/timmywil/repos","events_url":"https://api.github.com/users/timmywil/events{/privacy}","received_events_url":"https://api.github.com/users/timmywil/received_events","type":"User","site_admin":false},"created_at":"2015-03-07T13:53:06Z","updated_at":"2015-03-07T13:53:06Z","body":"Factory is more accurate, but it may not always be a factory. Regardless, it's probably better than referring to it as a constructor. "}}