{"action":"created","issue":{"url":"https://api.github.com/repos/videojs/video.js/issues/2711","labels_url":"https://api.github.com/repos/videojs/video.js/issues/2711/labels{/name}","comments_url":"https://api.github.com/repos/videojs/video.js/issues/2711/comments","events_url":"https://api.github.com/repos/videojs/video.js/issues/2711/events","html_url":"https://github.com/videojs/video.js/issues/2711","id":112039416,"number":2711,"title":"Videojs 5.0 API documentation missing argument names in some places","user":{"login":"Soviut","id":226882,"avatar_url":"https://avatars.githubusercontent.com/u/226882?v=3","gravatar_id":"","url":"https://api.github.com/users/Soviut","html_url":"https://github.com/Soviut","followers_url":"https://api.github.com/users/Soviut/followers","following_url":"https://api.github.com/users/Soviut/following{/other_user}","gists_url":"https://api.github.com/users/Soviut/gists{/gist_id}","starred_url":"https://api.github.com/users/Soviut/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/Soviut/subscriptions","organizations_url":"https://api.github.com/users/Soviut/orgs","repos_url":"https://api.github.com/users/Soviut/repos","events_url":"https://api.github.com/users/Soviut/events{/privacy}","received_events_url":"https://api.github.com/users/Soviut/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/videojs/video.js/labels/documentation","name":"documentation","color":"eb6420"}],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":6,"created_at":"2015-10-18T20:30:35Z","updated_at":"2015-10-21T23:13:07Z","closed_at":null,"body":"On the http://docs.videojs.com/docs/api/video.html page several methods have the wrong names for arguments, for example:\r\n\r\nhttp://docs.videojs.com/docs/api/video.html#MethodsmergeOptions\r\nhttp://docs.videojs.com/docs/api/video.html#Methodsplugin\r\n\r\nThis is because their params definitions in the jsdoc block are missing a name before their description and it's using the first word of the description as a name instead.\r\n\r\nhttps://github.com/videojs/video.js/blob/master/src/js/video.js#L260\r\n\r\n```javascript\r\n * @param {Object} The options object whose values will be overriden\r\n * @param {Object} The options object with values to override the first\r\n * @param {Object} Any number of additional options objects\r\n```\r\n\r\nWhen it should be something like:\r\n```javascript\r\n * @param {Object} first     The options object whose values will be overriden\r\n * @param {Object} second    The options object with values to override the first\r\n * @param {Object} etc       Any number of additional options objects\r\n```"},"comment":{"url":"https://api.github.com/repos/videojs/video.js/issues/comments/150050435","html_url":"https://github.com/videojs/video.js/issues/2711#issuecomment-150050435","issue_url":"https://api.github.com/repos/videojs/video.js/issues/2711","id":150050435,"user":{"login":"Soviut","id":226882,"avatar_url":"https://avatars.githubusercontent.com/u/226882?v=3","gravatar_id":"","url":"https://api.github.com/users/Soviut","html_url":"https://github.com/Soviut","followers_url":"https://api.github.com/users/Soviut/followers","following_url":"https://api.github.com/users/Soviut/following{/other_user}","gists_url":"https://api.github.com/users/Soviut/gists{/gist_id}","starred_url":"https://api.github.com/users/Soviut/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/Soviut/subscriptions","organizations_url":"https://api.github.com/users/Soviut/orgs","repos_url":"https://api.github.com/users/Soviut/repos","events_url":"https://api.github.com/users/Soviut/events{/privacy}","received_events_url":"https://api.github.com/users/Soviut/received_events","type":"User","site_admin":false},"created_at":"2015-10-21T23:13:07Z","updated_at":"2015-10-21T23:13:07Z","body":"I've realized there are more missing names in the docs that I could fix."}}