From 822a960e65427c7456b7e1f053e0854442c50f26 Mon Sep 17 00:00:00 2001 From: Mark Hoeber Date: Mon, 3 Feb 2014 13:10:11 -0500 Subject: [PATCH] Add info to external graders chapter Links to example pull/push repositories Note about graders not accessing student IDs --- docs/en_us/course_authors/source/external_graders.rst | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/docs/en_us/course_authors/source/external_graders.rst b/docs/en_us/course_authors/source/external_graders.rst index 121416e165..0633e2bb14 100644 --- a/docs/en_us/course_authors/source/external_graders.rst +++ b/docs/en_us/course_authors/source/external_graders.rst @@ -65,12 +65,16 @@ In Pull mode, student submissions are collected in XQueue, where they remain unt The external grader polls the XQueue through a RESTful interface at a regular interval. When the external grader receives 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. +For example code of an external grader that uses Pull mode, see the `Stanford-Online repository xqueue_pull_ref `_. + ================== Push Mode ================== In Push mode, XQueue actively pushes student submissions to the external grader, which passively waits for the next submission to grade. When the external grader receives a submission, it runs the tests on it, then synchronously delivers the graded response back to the XQueue. XQueue then delivers the response to the edX Learning Management System. +For example code of an external grader that uses Push mode, see the `edX repository xserver `_. + ============================ External Grader Workflow @@ -101,6 +105,10 @@ The XQueue Interface The student submission sent from XQueue to the grader, and the response sent from the grader to XQueue, are JSON objects, as described below. +.. note:: XQueue does not send the the student ID to the external grader. Your grader cannot access student IDs or associate student IDs with submissions. + +For the code for the XQueue interface, see the file `urls.py in the edX XQueue repository `_. + ====================================================== Inputs to the External Grader ======================================================