From a1dbc3bbd6bc70263a1ece95d8bcda7108b596bd Mon Sep 17 00:00:00 2001 From: David Baumgold Date: Thu, 27 Feb 2014 09:45:45 -0500 Subject: [PATCH] Start documenting Staff Debug Info STUD-1273 --- docs/en_us/course_authors/source/index.rst | 1 + .../source/staff_debug_info.rst | 37 +++++++++++++++++++ 2 files changed, 38 insertions(+) create mode 100644 docs/en_us/course_authors/source/staff_debug_info.rst diff --git a/docs/en_us/course_authors/source/index.rst b/docs/en_us/course_authors/source/index.rst index 145c6191fd..89c2f51197 100755 --- a/docs/en_us/course_authors/source/index.rst +++ b/docs/en_us/course_authors/source/index.rst @@ -44,6 +44,7 @@ Contents beta_testing course_student course_grades + staff_debug_info glossary diff --git a/docs/en_us/course_authors/source/staff_debug_info.rst b/docs/en_us/course_authors/source/staff_debug_info.rst new file mode 100644 index 0000000000..7f6e93d9c5 --- /dev/null +++ b/docs/en_us/course_authors/source/staff_debug_info.rst @@ -0,0 +1,37 @@ +.. _Staff Debug Info: + +############################ +Staff Debug Info +############################ + +The edX system keeps track of students' progress through a course -- recording +when the student watches videos, responds to problems, and so on. If you are +a staff member on a course, some of that data is visible to you for debugging +purposes. Under every problem is a link called "Staff Debug Info": clicking +that link causes a popup to appear that contains various metadata about the +problem. + +None of this information should be necessary for day-to-day usage of edX, +but for the sake of clarity, some of these fields are documented here: + +``is_released`` + Indicates whether the problem is visible to students. +``location`` + An internal unique identifier that corresponds to this problem. If you + are having trouble with a problem, and need assistance from the edX support + team, including this value will make it easier for them to track down the + issue you're having with the problem. +``markdown`` + The text of the problem, in Markdown format. This is often written using + Studio. +``display_name`` + The name of the problem, as shown to the student. +``max_attempts`` + The maximum number of times that a student can attempt to answer the problem + correctly. +``attempts`` + The number of times that the currently logged in student has attempted to + answer the problem correctly, so far. Every time this student attempts to answer + this question, this number will go up, until it reaches ``max_attempts``. + +