{"action":"created","comment":{"url":"https://api.github.com/repos/gengo/gengo-php/pulls/comments/32693211","id":32693211,"diff_hunk":"@@ -91,28 +91,22 @@ public function getJobs($ids = null, $format = null, $params = null, $version =\n      *\n      * Updates jobs to translate. returns these jobs back to the translators for revisions.\n      *\n-     * @param array $jobs (required) the payloads to identify the jobs sent back for revisions:\n-     *  - \"comment\" (required) the reason to the translator for sending the job back for revisions.\n-     *      AND\n-     *  One of the following format for job identification (note: all jobs must have the same format):\n-     *  - \"job_id\" the job's id\n-            OR\n-     *  - \"body_src\", the original body of text to be translated,\n-     *  - \"lc_src\", the source language code,\n-     *  - \"lc_tgt\", the target language code.\n+     * @param array $jobs (required) An array of arrays i.e. $jobs[] = array('job_id' => 12345, 'comment' => 'A comment here')\n+     * Note: the comment in the above $jobs array is optional if the $comment parameters is passed to this method\n+     * @param string $comment The comment that will be applied to all of the jobs that don't have one\n      * @param string $version Version of the API to use. Defaults to 'v2'.\n      */\n-    public function revise($jobs, $version = 'v2')\n+    public function revise(array $jobs, $comment = NULL, $version = 'v2')\n     {\n         // pack the jobs\n-        $data = array('action' => 'revise');\n-        $first_job = current($jobs);\n-        if (isset($first_job['job_id']))\n+        $data = array('action' => 'revise',\n+                      'job_ids' => $jobs);","path":"libs/Gengo/Api/Jobs.php","position":26,"original_position":26,"commit_id":"06c08ada83f6b8aba702460f5b05b73f2788fad4","original_commit_id":"06c08ada83f6b8aba702460f5b05b73f2788fad4","user":{"login":"toshipon","id":60810,"avatar_url":"https://avatars.githubusercontent.com/u/60810?v=3","gravatar_id":"","url":"https://api.github.com/users/toshipon","html_url":"https://github.com/toshipon","followers_url":"https://api.github.com/users/toshipon/followers","following_url":"https://api.github.com/users/toshipon/following{/other_user}","gists_url":"https://api.github.com/users/toshipon/gists{/gist_id}","starred_url":"https://api.github.com/users/toshipon/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/toshipon/subscriptions","organizations_url":"https://api.github.com/users/toshipon/orgs","repos_url":"https://api.github.com/users/toshipon/repos","events_url":"https://api.github.com/users/toshipon/events{/privacy}","received_events_url":"https://api.github.com/users/toshipon/received_events","type":"User","site_admin":false},"body":"Is property name `job_ids` is correct ? looks `$jobs` is array of job object. it's not id's list actually..","created_at":"2015-06-18T01:43:25Z","updated_at":"2015-06-18T01:43:25Z","html_url":"https://github.com/gengo/gengo-php/pull/33#discussion_r32693211","pull_request_url":"https://api.github.com/repos/gengo/gengo-php/pulls/33","_links":{"self":{"href":"https://api.github.com/repos/gengo/gengo-php/pulls/comments/32693211"},"html":{"href":"https://github.com/gengo/gengo-php/pull/33#discussion_r32693211"},"pull_request":{"href":"https://api.github.com/repos/gengo/gengo-php/pulls/33"}}},"pull_request":{"url":"https://api.github.com/repos/gengo/gengo-php/pulls/33","id":37963310,"html_url":"https://github.com/gengo/gengo-php/pull/33","diff_url":"https://github.com/gengo/gengo-php/pull/33.diff","patch_url":"https://github.com/gengo/gengo-php/pull/33.patch","issue_url":"https://api.github.com/repos/gengo/gengo-php/issues/33","number":33,"state":"open","locked":false,"title":"96724186 improve revise comment","user":{"login":"hayate","id":92108,"avatar_url":"https://avatars.githubusercontent.com/u/92108?v=3","gravatar_id":"","url":"https://api.github.com/users/hayate","html_url":"https://github.com/hayate","followers_url":"https://api.github.com/users/hayate/followers","following_url":"https://api.github.com/users/hayate/following{/other_user}","gists_url":"https://api.github.com/users/hayate/gists{/gist_id}","starred_url":"https://api.github.com/users/hayate/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/hayate/subscriptions","organizations_url":"https://api.github.com/users/hayate/orgs","repos_url":"https://api.github.com/users/hayate/repos","events_url":"https://api.github.com/users/hayate/events{/privacy}","received_events_url":"https://api.github.com/users/hayate/received_events","type":"User","site_admin":false},"body":"* add optional `$comment` parameter to revise and reject PUT requests\r\n* remove obsolete PUT requests payload format \r\n* improve doc comments","created_at":"2015-06-18T01:11:06Z","updated_at":"2015-06-18T01:43:25Z","closed_at":null,"merged_at":null,"merge_commit_sha":"b26c44ca77da03ccc42d73281f5f1a55e8621ce9","assignee":null,"milestone":null,"commits_url":"https://api.github.com/repos/gengo/gengo-php/pulls/33/commits","review_comments_url":"https://api.github.com/repos/gengo/gengo-php/pulls/33/comments","review_comment_url":"https://api.github.com/repos/gengo/gengo-php/pulls/comments{/number}","comments_url":"https://api.github.com/repos/gengo/gengo-php/issues/33/comments","statuses_url":"https://api.github.com/repos/gengo/gengo-php/statuses/06c08ada83f6b8aba702460f5b05b73f2788fad4","head":{"label":"gengo:96724186-improve-revise-comment","ref":"96724186-improve-revise-comment","sha":"06c08ada83f6b8aba702460f5b05b73f2788fad4","user":{"login":"gengo","id":1681251,"avatar_url":"https://avatars.githubusercontent.com/u/1681251?v=3","gravatar_id":"","url":"https://api.github.com/users/gengo","html_url":"https://github.com/gengo","followers_url":"https://api.github.com/users/gengo/followers","following_url":"https://api.github.com/users/gengo/following{/other_user}","gists_url":"https://api.github.com/users/gengo/gists{/gist_id}","starred_url":"https://api.github.com/users/gengo/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/gengo/subscriptions","organizations_url":"https://api.github.com/users/gengo/orgs","repos_url":"https://api.github.com/users/gengo/repos","events_url":"https://api.github.com/users/gengo/events{/privacy}","received_events_url":"https://api.github.com/users/gengo/received_events","type":"Organization","site_admin":false},"repo":{"id":6772551,"name":"gengo-php","full_name":"gengo/gengo-php","owner":{"login":"gengo","id":1681251,"avatar_url":"https://avatars.githubusercontent.com/u/1681251?v=3","gravatar_id":"","url":"https://api.github.com/users/gengo","html_url":"https://github.com/gengo","followers_url":"https://api.github.com/users/gengo/followers","following_url":"https://api.github.com/users/gengo/following{/other_user}","gists_url":"https://api.github.com/users/gengo/gists{/gist_id}","starred_url":"https://api.github.com/users/gengo/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/gengo/subscriptions","organizations_url":"https://api.github.com/users/gengo/orgs","repos_url":"https://api.github.com/users/gengo/repos","events_url":"https://api.github.com/users/gengo/events{/privacy}","received_events_url":"https://api.github.com/users/gengo/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/gengo/gengo-php","description":"A PHP library to interface with the Gengo API for translation.","fork":false,"url":"https://api.github.com/repos/gengo/gengo-php","forks_url":"https://api.github.com/repos/gengo/gengo-php/forks","keys_url":"https://api.github.com/repos/gengo/gengo-php/keys{/key_id}","collaborators_url":"https://api.github.com/repos/gengo/gengo-php/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/gengo/gengo-php/teams","hooks_url":"https://api.github.com/repos/gengo/gengo-php/hooks","issue_events_url":"https://api.github.com/repos/gengo/gengo-php/issues/events{/number}","events_url":"https://api.github.com/repos/gengo/gengo-php/events","assignees_url":"https://api.github.com/repos/gengo/gengo-php/assignees{/user}","branches_url":"https://api.github.com/repos/gengo/gengo-php/branches{/branch}","tags_url":"https://api.github.com/repos/gengo/gengo-php/tags","blobs_url":"https://api.github.com/repos/gengo/gengo-php/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/gengo/gengo-php/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/gengo/gengo-php/git/refs{/sha}","trees_url":"https://api.github.com/repos/gengo/gengo-php/git/trees{/sha}","statuses_url":"https://api.github.com/repos/gengo/gengo-php/statuses/{sha}","languages_url":"https://api.github.com/repos/gengo/gengo-php/languages","stargazers_url":"https://api.github.com/repos/gengo/gengo-php/stargazers","contributors_url":"https://api.github.com/repos/gengo/gengo-php/contributors","subscribers_url":"https://api.github.com/repos/gengo/gengo-php/subscribers","subscription_url":"https://api.github.com/repos/gengo/gengo-php/subscription","commits_url":"https://api.github.com/repos/gengo/gengo-php/commits{/sha}","git_commits_url":"https://api.github.com/repos/gengo/gengo-php/git/commits{/sha}","comments_url":"https://api.github.com/repos/gengo/gengo-php/comments{/number}","issue_comment_url":"https://api.github.com/repos/gengo/gengo-php/issues/comments{/number}","contents_url":"https://api.github.com/repos/gengo/gengo-php/contents/{+path}","compare_url":"https://api.github.com/repos/gengo/gengo-php/compare/{base}...{head}","merges_url":"https://api.github.com/repos/gengo/gengo-php/merges","archive_url":"https://api.github.com/repos/gengo/gengo-php/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/gengo/gengo-php/downloads","issues_url":"https://api.github.com/repos/gengo/gengo-php/issues{/number}","pulls_url":"https://api.github.com/repos/gengo/gengo-php/pulls{/number}","milestones_url":"https://api.github.com/repos/gengo/gengo-php/milestones{/number}","notifications_url":"https://api.github.com/repos/gengo/gengo-php/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/gengo/gengo-php/labels{/name}","releases_url":"https://api.github.com/repos/gengo/gengo-php/releases{/id}","created_at":"2012-11-20T05:19:08Z","updated_at":"2015-05-20T05:13:54Z","pushed_at":"2015-06-18T01:11:07Z","git_url":"git://github.com/gengo/gengo-php.git","ssh_url":"git@github.com:gengo/gengo-php.git","clone_url":"https://github.com/gengo/gengo-php.git","svn_url":"https://github.com/gengo/gengo-php","homepage":"http://gengo.com/api/","size":1020,"stargazers_count":14,"watchers_count":14,"language":"PHP","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":15,"mirror_url":null,"open_issues_count":3,"forks":15,"open_issues":3,"watchers":14,"default_branch":"master"}},"base":{"label":"gengo:master","ref":"master","sha":"5788f039a53df868b9bb885538120d353e1ab12b","user":{"login":"gengo","id":1681251,"avatar_url":"https://avatars.githubusercontent.com/u/1681251?v=3","gravatar_id":"","url":"https://api.github.com/users/gengo","html_url":"https://github.com/gengo","followers_url":"https://api.github.com/users/gengo/followers","following_url":"https://api.github.com/users/gengo/following{/other_user}","gists_url":"https://api.github.com/users/gengo/gists{/gist_id}","starred_url":"https://api.github.com/users/gengo/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/gengo/subscriptions","organizations_url":"https://api.github.com/users/gengo/orgs","repos_url":"https://api.github.com/users/gengo/repos","events_url":"https://api.github.com/users/gengo/events{/privacy}","received_events_url":"https://api.github.com/users/gengo/received_events","type":"Organization","site_admin":false},"repo":{"id":6772551,"name":"gengo-php","full_name":"gengo/gengo-php","owner":{"login":"gengo","id":1681251,"avatar_url":"https://avatars.githubusercontent.com/u/1681251?v=3","gravatar_id":"","url":"https://api.github.com/users/gengo","html_url":"https://github.com/gengo","followers_url":"https://api.github.com/users/gengo/followers","following_url":"https://api.github.com/users/gengo/following{/other_user}","gists_url":"https://api.github.com/users/gengo/gists{/gist_id}","starred_url":"https://api.github.com/users/gengo/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/gengo/subscriptions","organizations_url":"https://api.github.com/users/gengo/orgs","repos_url":"https://api.github.com/users/gengo/repos","events_url":"https://api.github.com/users/gengo/events{/privacy}","received_events_url":"https://api.github.com/users/gengo/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/gengo/gengo-php","description":"A PHP library to interface with the Gengo API for translation.","fork":false,"url":"https://api.github.com/repos/gengo/gengo-php","forks_url":"https://api.github.com/repos/gengo/gengo-php/forks","keys_url":"https://api.github.com/repos/gengo/gengo-php/keys{/key_id}","collaborators_url":"https://api.github.com/repos/gengo/gengo-php/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/gengo/gengo-php/teams","hooks_url":"https://api.github.com/repos/gengo/gengo-php/hooks","issue_events_url":"https://api.github.com/repos/gengo/gengo-php/issues/events{/number}","events_url":"https://api.github.com/repos/gengo/gengo-php/events","assignees_url":"https://api.github.com/repos/gengo/gengo-php/assignees{/user}","branches_url":"https://api.github.com/repos/gengo/gengo-php/branches{/branch}","tags_url":"https://api.github.com/repos/gengo/gengo-php/tags","blobs_url":"https://api.github.com/repos/gengo/gengo-php/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/gengo/gengo-php/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/gengo/gengo-php/git/refs{/sha}","trees_url":"https://api.github.com/repos/gengo/gengo-php/git/trees{/sha}","statuses_url":"https://api.github.com/repos/gengo/gengo-php/statuses/{sha}","languages_url":"https://api.github.com/repos/gengo/gengo-php/languages","stargazers_url":"https://api.github.com/repos/gengo/gengo-php/stargazers","contributors_url":"https://api.github.com/repos/gengo/gengo-php/contributors","subscribers_url":"https://api.github.com/repos/gengo/gengo-php/subscribers","subscription_url":"https://api.github.com/repos/gengo/gengo-php/subscription","commits_url":"https://api.github.com/repos/gengo/gengo-php/commits{/sha}","git_commits_url":"https://api.github.com/repos/gengo/gengo-php/git/commits{/sha}","comments_url":"https://api.github.com/repos/gengo/gengo-php/comments{/number}","issue_comment_url":"https://api.github.com/repos/gengo/gengo-php/issues/comments{/number}","contents_url":"https://api.github.com/repos/gengo/gengo-php/contents/{+path}","compare_url":"https://api.github.com/repos/gengo/gengo-php/compare/{base}...{head}","merges_url":"https://api.github.com/repos/gengo/gengo-php/merges","archive_url":"https://api.github.com/repos/gengo/gengo-php/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/gengo/gengo-php/downloads","issues_url":"https://api.github.com/repos/gengo/gengo-php/issues{/number}","pulls_url":"https://api.github.com/repos/gengo/gengo-php/pulls{/number}","milestones_url":"https://api.github.com/repos/gengo/gengo-php/milestones{/number}","notifications_url":"https://api.github.com/repos/gengo/gengo-php/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/gengo/gengo-php/labels{/name}","releases_url":"https://api.github.com/repos/gengo/gengo-php/releases{/id}","created_at":"2012-11-20T05:19:08Z","updated_at":"2015-05-20T05:13:54Z","pushed_at":"2015-06-18T01:11:07Z","git_url":"git://github.com/gengo/gengo-php.git","ssh_url":"git@github.com:gengo/gengo-php.git","clone_url":"https://github.com/gengo/gengo-php.git","svn_url":"https://github.com/gengo/gengo-php","homepage":"http://gengo.com/api/","size":1020,"stargazers_count":14,"watchers_count":14,"language":"PHP","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":15,"mirror_url":null,"open_issues_count":3,"forks":15,"open_issues":3,"watchers":14,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/gengo/gengo-php/pulls/33"},"html":{"href":"https://github.com/gengo/gengo-php/pull/33"},"issue":{"href":"https://api.github.com/repos/gengo/gengo-php/issues/33"},"comments":{"href":"https://api.github.com/repos/gengo/gengo-php/issues/33/comments"},"review_comments":{"href":"https://api.github.com/repos/gengo/gengo-php/pulls/33/comments"},"review_comment":{"href":"https://api.github.com/repos/gengo/gengo-php/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/gengo/gengo-php/pulls/33/commits"},"statuses":{"href":"https://api.github.com/repos/gengo/gengo-php/statuses/06c08ada83f6b8aba702460f5b05b73f2788fad4"}}}}