{"action":"created","comment":{"url":"https://api.github.com/repos/edx/edx-documentation/pulls/comments/30043663","id":30043663,"diff_hunk":"@@ -46,35 +59,57 @@ The external grader can return a string with results, which the student can see\n External Graders and XQueue\n **************************************\n \n-The edX Platform communicates with your external grader through XQueue.  XQueue provides students' input to the grader; it then receives results from the grader and returns them to students.  \n-\n-Student submissions are collected in XQueue, where they remain until the grader actively retrieves, or pulls, the next submission from the queue for grading.\n+The edX Platform communicates with your external grader through XQueue. XQueue\n+provides learners' input to the grader; it then receives results from the\n+grader and returns them to learners.\n \n-The external grader polls the XQueue through a RESTful interface at a regular interval. When the external grader pulls a submission, it runs the tests on it, then pushes the response back to XQueue through the RESTful interface. XQueue then delivers the response to the edX Learning Management System.\n+Submissions are collected in XQueue, where they remain until the grader\n+actively retrieves, or pulls, the next submission from the queue for grading.\n \n-For example code of an external grader that uses Pull mode, see the `Stanford-Online repository xqueue_pull_ref <https://github.com/Stanford-Online/xqueue_pull_ref>`_.\n+The external grader polls the XQueue through a RESTful interface at a regular\n+interval. When the external grader pulls a submission, it runs the tests on it,\n+then pushes the response back to XQueue through the RESTful interface. XQueue\n+then delivers the response to the edX Learning Management System.\n \n+For example code of an external grader that uses Pull mode, see the `Stanford-\n+Online repository xqueue_pull_ref <https://github.com/Stanford-\n+Online/xqueue_pull_ref>`_.\n \n ============================\n External Grader Workflow\n ============================\n \n-The following steps show the complete process:\n+The following steps show the complete process of how a problem is processed by\n+an external grader.\n+\n+#. The learner either enters code or attaches a file for a problem, then\n+   selects Check.\n \n-#. The student either enters code or attaches a file for a problem, then clicks Check.\n #. The external grader pulls the code from XQueue.\n+\n #. The external grader runs the tests that you created on the code.\n-#. The external grader returns the grade for the submission, as well as any results in a string, to XQueue. \n+\n+#. The external grader returns the grade for the submission, as well as any\n+   results in a string, to XQueue.\n+\n #. The XQueue delivers the results to the edX Learning Management System.\n-#. The student sees the problem results and the grade.\n \n+#. The learner sees the problem results and the grade.\n \n ==================\n The XQueue Name\n ==================\n \n-Your course will use a specific XQueue name. You use this name when creating problems in edX Studio. You get this name from your edX Program Manager. As edX hosts many XQueues for different courses, it is critical that you use the exact XQueue name in your problems, as described in the section :ref:`Create a Code Response Problem`. \n+Your course will use a specific XQueue name. You use this name when creating","path":"en_us/shared/exercises_tools/external_graders.rst","position":102,"original_position":102,"commit_id":"2053d0beaa0caada262cd4f35e3cbbf745716ab5","original_commit_id":"2053d0beaa0caada262cd4f35e3cbbf745716ab5","user":{"login":"srpearce","id":3493253,"avatar_url":"https://avatars.githubusercontent.com/u/3493253?v=3","gravatar_id":"","url":"https://api.github.com/users/srpearce","html_url":"https://github.com/srpearce","followers_url":"https://api.github.com/users/srpearce/followers","following_url":"https://api.github.com/users/srpearce/following{/other_user}","gists_url":"https://api.github.com/users/srpearce/gists{/gist_id}","starred_url":"https://api.github.com/users/srpearce/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/srpearce/subscriptions","organizations_url":"https://api.github.com/users/srpearce/orgs","repos_url":"https://api.github.com/users/srpearce/repos","events_url":"https://api.github.com/users/srpearce/events{/privacy}","received_events_url":"https://api.github.com/users/srpearce/received_events","type":"User","site_admin":false},"body":"when you create","created_at":"2015-05-11T14:37:35Z","updated_at":"2015-05-11T14:37:35Z","html_url":"https://github.com/edx/edx-documentation/pull/319#discussion_r30043663","pull_request_url":"https://api.github.com/repos/edx/edx-documentation/pulls/319","_links":{"self":{"href":"https://api.github.com/repos/edx/edx-documentation/pulls/comments/30043663"},"html":{"href":"https://github.com/edx/edx-documentation/pull/319#discussion_r30043663"},"pull_request":{"href":"https://api.github.com/repos/edx/edx-documentation/pulls/319"}}},"pull_request":{"url":"https://api.github.com/repos/edx/edx-documentation/pulls/319","id":34508059,"html_url":"https://github.com/edx/edx-documentation/pull/319","diff_url":"https://github.com/edx/edx-documentation/pull/319.diff","patch_url":"https://github.com/edx/edx-documentation/pull/319.patch","issue_url":"https://api.github.com/repos/edx/edx-documentation/issues/319","number":319,"state":"open","locked":false,"title":"WIP: Hackathon Project","user":{"login":"mhoeber","id":5607222,"avatar_url":"https://avatars.githubusercontent.com/u/5607222?v=3","gravatar_id":"","url":"https://api.github.com/users/mhoeber","html_url":"https://github.com/mhoeber","followers_url":"https://api.github.com/users/mhoeber/followers","following_url":"https://api.github.com/users/mhoeber/following{/other_user}","gists_url":"https://api.github.com/users/mhoeber/gists{/gist_id}","starred_url":"https://api.github.com/users/mhoeber/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mhoeber/subscriptions","organizations_url":"https://api.github.com/users/mhoeber/orgs","repos_url":"https://api.github.com/users/mhoeber/repos","events_url":"https://api.github.com/users/mhoeber/events{/privacy}","received_events_url":"https://api.github.com/users/mhoeber/received_events","type":"User","site_admin":false},"body":"","created_at":"2015-04-30T22:38:36Z","updated_at":"2015-05-11T14:37:35Z","closed_at":null,"merged_at":null,"merge_commit_sha":"2d6a97ea07a1edf504e611b8545eba0782f46240","assignee":null,"milestone":null,"commits_url":"https://api.github.com/repos/edx/edx-documentation/pulls/319/commits","review_comments_url":"https://api.github.com/repos/edx/edx-documentation/pulls/319/comments","review_comment_url":"https://api.github.com/repos/edx/edx-documentation/pulls/comments{/number}","comments_url":"https://api.github.com/repos/edx/edx-documentation/issues/319/comments","statuses_url":"https://api.github.com/repos/edx/edx-documentation/statuses/2053d0beaa0caada262cd4f35e3cbbf745716ab5","head":{"label":"edx:markhoeber-doc1858","ref":"markhoeber-doc1858","sha":"2053d0beaa0caada262cd4f35e3cbbf745716ab5","user":{"login":"edx","id":3179841,"avatar_url":"https://avatars.githubusercontent.com/u/3179841?v=3","gravatar_id":"","url":"https://api.github.com/users/edx","html_url":"https://github.com/edx","followers_url":"https://api.github.com/users/edx/followers","following_url":"https://api.github.com/users/edx/following{/other_user}","gists_url":"https://api.github.com/users/edx/gists{/gist_id}","starred_url":"https://api.github.com/users/edx/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/edx/subscriptions","organizations_url":"https://api.github.com/users/edx/orgs","repos_url":"https://api.github.com/users/edx/repos","events_url":"https://api.github.com/users/edx/events{/privacy}","received_events_url":"https://api.github.com/users/edx/received_events","type":"Organization","site_admin":false},"repo":{"id":23839256,"name":"edx-documentation","full_name":"edx/edx-documentation","owner":{"login":"edx","id":3179841,"avatar_url":"https://avatars.githubusercontent.com/u/3179841?v=3","gravatar_id":"","url":"https://api.github.com/users/edx","html_url":"https://github.com/edx","followers_url":"https://api.github.com/users/edx/followers","following_url":"https://api.github.com/users/edx/following{/other_user}","gists_url":"https://api.github.com/users/edx/gists{/gist_id}","starred_url":"https://api.github.com/users/edx/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/edx/subscriptions","organizations_url":"https://api.github.com/users/edx/orgs","repos_url":"https://api.github.com/users/edx/repos","events_url":"https://api.github.com/users/edx/events{/privacy}","received_events_url":"https://api.github.com/users/edx/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/edx/edx-documentation","description":"","fork":false,"url":"https://api.github.com/repos/edx/edx-documentation","forks_url":"https://api.github.com/repos/edx/edx-documentation/forks","keys_url":"https://api.github.com/repos/edx/edx-documentation/keys{/key_id}","collaborators_url":"https://api.github.com/repos/edx/edx-documentation/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/edx/edx-documentation/teams","hooks_url":"https://api.github.com/repos/edx/edx-documentation/hooks","issue_events_url":"https://api.github.com/repos/edx/edx-documentation/issues/events{/number}","events_url":"https://api.github.com/repos/edx/edx-documentation/events","assignees_url":"https://api.github.com/repos/edx/edx-documentation/assignees{/user}","branches_url":"https://api.github.com/repos/edx/edx-documentation/branches{/branch}","tags_url":"https://api.github.com/repos/edx/edx-documentation/tags","blobs_url":"https://api.github.com/repos/edx/edx-documentation/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/edx/edx-documentation/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/edx/edx-documentation/git/refs{/sha}","trees_url":"https://api.github.com/repos/edx/edx-documentation/git/trees{/sha}","statuses_url":"https://api.github.com/repos/edx/edx-documentation/statuses/{sha}","languages_url":"https://api.github.com/repos/edx/edx-documentation/languages","stargazers_url":"https://api.github.com/repos/edx/edx-documentation/stargazers","contributors_url":"https://api.github.com/repos/edx/edx-documentation/contributors","subscribers_url":"https://api.github.com/repos/edx/edx-documentation/subscribers","subscription_url":"https://api.github.com/repos/edx/edx-documentation/subscription","commits_url":"https://api.github.com/repos/edx/edx-documentation/commits{/sha}","git_commits_url":"https://api.github.com/repos/edx/edx-documentation/git/commits{/sha}","comments_url":"https://api.github.com/repos/edx/edx-documentation/comments{/number}","issue_comment_url":"https://api.github.com/repos/edx/edx-documentation/issues/comments{/number}","contents_url":"https://api.github.com/repos/edx/edx-documentation/contents/{+path}","compare_url":"https://api.github.com/repos/edx/edx-documentation/compare/{base}...{head}","merges_url":"https://api.github.com/repos/edx/edx-documentation/merges","archive_url":"https://api.github.com/repos/edx/edx-documentation/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/edx/edx-documentation/downloads","issues_url":"https://api.github.com/repos/edx/edx-documentation/issues{/number}","pulls_url":"https://api.github.com/repos/edx/edx-documentation/pulls{/number}","milestones_url":"https://api.github.com/repos/edx/edx-documentation/milestones{/number}","notifications_url":"https://api.github.com/repos/edx/edx-documentation/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/edx/edx-documentation/labels{/name}","releases_url":"https://api.github.com/repos/edx/edx-documentation/releases{/id}","created_at":"2014-09-09T15:29:04Z","updated_at":"2015-05-09T08:33:56Z","pushed_at":"2015-05-11T14:10:45Z","git_url":"git://github.com/edx/edx-documentation.git","ssh_url":"git@github.com:edx/edx-documentation.git","clone_url":"https://github.com/edx/edx-documentation.git","svn_url":"https://github.com/edx/edx-documentation","homepage":null,"size":81174,"stargazers_count":14,"watchers_count":14,"language":"CSS","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":45,"mirror_url":null,"open_issues_count":21,"forks":45,"open_issues":21,"watchers":14,"default_branch":"master"}},"base":{"label":"edx:master","ref":"master","sha":"28d2e9ea34f7a066692eedf46985290bce04b1b5","user":{"login":"edx","id":3179841,"avatar_url":"https://avatars.githubusercontent.com/u/3179841?v=3","gravatar_id":"","url":"https://api.github.com/users/edx","html_url":"https://github.com/edx","followers_url":"https://api.github.com/users/edx/followers","following_url":"https://api.github.com/users/edx/following{/other_user}","gists_url":"https://api.github.com/users/edx/gists{/gist_id}","starred_url":"https://api.github.com/users/edx/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/edx/subscriptions","organizations_url":"https://api.github.com/users/edx/orgs","repos_url":"https://api.github.com/users/edx/repos","events_url":"https://api.github.com/users/edx/events{/privacy}","received_events_url":"https://api.github.com/users/edx/received_events","type":"Organization","site_admin":false},"repo":{"id":23839256,"name":"edx-documentation","full_name":"edx/edx-documentation","owner":{"login":"edx","id":3179841,"avatar_url":"https://avatars.githubusercontent.com/u/3179841?v=3","gravatar_id":"","url":"https://api.github.com/users/edx","html_url":"https://github.com/edx","followers_url":"https://api.github.com/users/edx/followers","following_url":"https://api.github.com/users/edx/following{/other_user}","gists_url":"https://api.github.com/users/edx/gists{/gist_id}","starred_url":"https://api.github.com/users/edx/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/edx/subscriptions","organizations_url":"https://api.github.com/users/edx/orgs","repos_url":"https://api.github.com/users/edx/repos","events_url":"https://api.github.com/users/edx/events{/privacy}","received_events_url":"https://api.github.com/users/edx/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/edx/edx-documentation","description":"","fork":false,"url":"https://api.github.com/repos/edx/edx-documentation","forks_url":"https://api.github.com/repos/edx/edx-documentation/forks","keys_url":"https://api.github.com/repos/edx/edx-documentation/keys{/key_id}","collaborators_url":"https://api.github.com/repos/edx/edx-documentation/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/edx/edx-documentation/teams","hooks_url":"https://api.github.com/repos/edx/edx-documentation/hooks","issue_events_url":"https://api.github.com/repos/edx/edx-documentation/issues/events{/number}","events_url":"https://api.github.com/repos/edx/edx-documentation/events","assignees_url":"https://api.github.com/repos/edx/edx-documentation/assignees{/user}","branches_url":"https://api.github.com/repos/edx/edx-documentation/branches{/branch}","tags_url":"https://api.github.com/repos/edx/edx-documentation/tags","blobs_url":"https://api.github.com/repos/edx/edx-documentation/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/edx/edx-documentation/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/edx/edx-documentation/git/refs{/sha}","trees_url":"https://api.github.com/repos/edx/edx-documentation/git/trees{/sha}","statuses_url":"https://api.github.com/repos/edx/edx-documentation/statuses/{sha}","languages_url":"https://api.github.com/repos/edx/edx-documentation/languages","stargazers_url":"https://api.github.com/repos/edx/edx-documentation/stargazers","contributors_url":"https://api.github.com/repos/edx/edx-documentation/contributors","subscribers_url":"https://api.github.com/repos/edx/edx-documentation/subscribers","subscription_url":"https://api.github.com/repos/edx/edx-documentation/subscription","commits_url":"https://api.github.com/repos/edx/edx-documentation/commits{/sha}","git_commits_url":"https://api.github.com/repos/edx/edx-documentation/git/commits{/sha}","comments_url":"https://api.github.com/repos/edx/edx-documentation/comments{/number}","issue_comment_url":"https://api.github.com/repos/edx/edx-documentation/issues/comments{/number}","contents_url":"https://api.github.com/repos/edx/edx-documentation/contents/{+path}","compare_url":"https://api.github.com/repos/edx/edx-documentation/compare/{base}...{head}","merges_url":"https://api.github.com/repos/edx/edx-documentation/merges","archive_url":"https://api.github.com/repos/edx/edx-documentation/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/edx/edx-documentation/downloads","issues_url":"https://api.github.com/repos/edx/edx-documentation/issues{/number}","pulls_url":"https://api.github.com/repos/edx/edx-documentation/pulls{/number}","milestones_url":"https://api.github.com/repos/edx/edx-documentation/milestones{/number}","notifications_url":"https://api.github.com/repos/edx/edx-documentation/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/edx/edx-documentation/labels{/name}","releases_url":"https://api.github.com/repos/edx/edx-documentation/releases{/id}","created_at":"2014-09-09T15:29:04Z","updated_at":"2015-05-09T08:33:56Z","pushed_at":"2015-05-11T14:10:45Z","git_url":"git://github.com/edx/edx-documentation.git","ssh_url":"git@github.com:edx/edx-documentation.git","clone_url":"https://github.com/edx/edx-documentation.git","svn_url":"https://github.com/edx/edx-documentation","homepage":null,"size":81174,"stargazers_count":14,"watchers_count":14,"language":"CSS","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":45,"mirror_url":null,"open_issues_count":21,"forks":45,"open_issues":21,"watchers":14,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/edx/edx-documentation/pulls/319"},"html":{"href":"https://github.com/edx/edx-documentation/pull/319"},"issue":{"href":"https://api.github.com/repos/edx/edx-documentation/issues/319"},"comments":{"href":"https://api.github.com/repos/edx/edx-documentation/issues/319/comments"},"review_comments":{"href":"https://api.github.com/repos/edx/edx-documentation/pulls/319/comments"},"review_comment":{"href":"https://api.github.com/repos/edx/edx-documentation/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/edx/edx-documentation/pulls/319/commits"},"statuses":{"href":"https://api.github.com/repos/edx/edx-documentation/statuses/2053d0beaa0caada262cd4f35e3cbbf745716ab5"}}}}