{"action":"created","issue":{"url":"https://api.github.com/repos/jashkenas/backbone/issues/3496","labels_url":"https://api.github.com/repos/jashkenas/backbone/issues/3496/labels{/name}","comments_url":"https://api.github.com/repos/jashkenas/backbone/issues/3496/comments","events_url":"https://api.github.com/repos/jashkenas/backbone/issues/3496/events","html_url":"https://github.com/jashkenas/backbone/issues/3496","id":57847840,"number":3496,"title":"Document Collection push() / unshift() args / return values","user":{"login":"jmm","id":129203,"avatar_url":"https://avatars.githubusercontent.com/u/129203?v=3","gravatar_id":"","url":"https://api.github.com/users/jmm","html_url":"https://github.com/jmm","followers_url":"https://api.github.com/users/jmm/followers","following_url":"https://api.github.com/users/jmm/following{/other_user}","gists_url":"https://api.github.com/users/jmm/gists{/gist_id}","starred_url":"https://api.github.com/users/jmm/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/jmm/subscriptions","organizations_url":"https://api.github.com/users/jmm/orgs","repos_url":"https://api.github.com/users/jmm/repos","events_url":"https://api.github.com/users/jmm/events{/privacy}","received_events_url":"https://api.github.com/users/jmm/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/jashkenas/backbone/labels/change","name":"change","color":"27823f"}],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":6,"created_at":"2015-02-16T20:26:19Z","updated_at":"2015-02-17T18:33:14Z","closed_at":null,"body":"1. `Backbone.Collection` `push()` and `unshift()` are documented as only accepting a single model, but under the hood they each pass their `model` arg to `add()`, which accepts a model or array as its `models` arg. Are they intended to be restricted to accepting a single model, or can they be documented as accepting an array (that is, accepting the same values that can be passed to `add()` as `models`)?\r\n\r\n2. There's no return value documented for those same methods, but they both return the return value from `add()`."},"comment":{"url":"https://api.github.com/repos/jashkenas/backbone/issues/comments/74723142","html_url":"https://github.com/jashkenas/backbone/issues/3496#issuecomment-74723142","issue_url":"https://api.github.com/repos/jashkenas/backbone/issues/3496","id":74723142,"user":{"login":"jmm","id":129203,"avatar_url":"https://avatars.githubusercontent.com/u/129203?v=3","gravatar_id":"","url":"https://api.github.com/users/jmm","html_url":"https://github.com/jmm","followers_url":"https://api.github.com/users/jmm/followers","following_url":"https://api.github.com/users/jmm/following{/other_user}","gists_url":"https://api.github.com/users/jmm/gists{/gist_id}","starred_url":"https://api.github.com/users/jmm/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/jmm/subscriptions","organizations_url":"https://api.github.com/users/jmm/orgs","repos_url":"https://api.github.com/users/jmm/repos","events_url":"https://api.github.com/users/jmm/events{/privacy}","received_events_url":"https://api.github.com/users/jmm/received_events","type":"User","site_admin":false},"created_at":"2015-02-17T18:33:14Z","updated_at":"2015-02-17T18:33:14Z","body":"Not to mention that it's undocumented that these methods trigger an `add` event."}}