{"action":"created","comment":{"url":"https://api.github.com/repos/edx/edx-documentation/pulls/comments/92202877","pull_request_review_id":12713986,"id":92202877,"diff_hunk":"@@ -6557,7 +6557,266 @@ clicks to request the generation of a report on the instructor dashboard.\n    * - ``student``\n      - string\n \n+.. _grading_events:\n \n+=============================\n+Grading-Related Events\n+=============================\n+\n+Grading-related events are emitted when grades at the subsection or course\n+level are updated. Changes to grades can result from a learner action such as\n+submitting a response to a problem, a course team member action on the\n+Instruction Dashboard such as rescoring a problem or deleting a learner's\n+state for a problem, or a course-level action such as calculation of a\n+learner's final grade for a course.\n+\n+This section presents grading-related events alphabetically.\n+\n+**Component**: LMS, Instructor Dashboard\n+\n+**Event Source**: Server\n+\n+**History**: Grading-related events were added on 28 Nov 2016.\n+\n+.. contents::\n+  :local:\n+  :depth: 1\n+\n+\n+.. _edx_grades_course_grade_calculated:\n+\n+``edx.grades.course.grade_calculated``\n+******************************************\n+\n+When a learner's grade for a course is successfully saved to the database, the\n+server emits an ``edx.grades.course.grade_calculated`` event.\n+\n+**Event Source**: Server\n+\n+``event`` **Member Fields**:\n+\n+In addition to the :ref:`common<context>` ``context`` member fields, this\n+event type also includes the following ``event`` member fields.\n+\n+.. list-table::\n+   :widths: 15 15 60\n+   :header-rows: 1\n+\n+   * - Field\n+     - Type\n+     - Details\n+   * - ``course_edited_on``\n+     - datetime\n+     - The timestamp of the most recent edit to the course at the time the\n+       grade was calculated.\n+   * - ``course_version``\n+     - string\n+     - The version of the course for which the problem was submitted.\n+   * - ``grading_policy_hash``\n+     - string\n+     - A hash of the grading policy at the time the grade was calculated.\n+   * - ``letter_grade``\n+     - string\n+     - The string or alphabetical letter representing the learner's course\n+       grade, as defined by the course's grading policy.\n+   * - ``percent``\n+     - float\n+     - The learner's course grade, expressed as a percentage.\n+   * - ``user_action_id``\n+     - string\n+     - The unique identifier of the learner or course team action.\n+   * - ``user_action_type``\n+     - string\n+     - A readable string representing the learner or course team action that\n+       triggered this event. Possible values are:\n+\n+\n+.. _edx_grades_problem_rescored:\n+\n+``edx.grades.problem.rescored``\n+*********************************\n+\n+When a course team member successfully rescores a learner's problem\n+submission, the server emits an ``edx.grades.problem.rescored`` event.\n+\n+**Event Source**: Server\n+\n+``event`` **Member Fields**:\n+\n+In addition to the :ref:`common<context>` ``context`` member fields, this\n+event type also includes the following ``event`` member fields.\n+\n+.. list-table::\n+   :widths: 15 15 60\n+   :header-rows: 1\n+\n+   * - Field\n+     - Type\n+     - Details\n+\n+   * - ``instructor_id``\n+     - string\n+     - The identifier for the course team member who initiated the rescore.\n+\n+   * - ``new_weighted_earned``\n+     - number\n+     - The learner's weighted score for the problem, after the rescore.\n+\n+   * - ``new_weighted_possible``\n+     - number\n+     - The weighted maximum score for the problem after the rescore.\n+\n+   * - ``only_if_higher``\n+     - boolean\n+     - Indicates whether the rescore was \"rescore only if higher\" or not.\n+\n+   * - ``original_weighted_earned``\n+     - number\n+     - The learner's weighted score for the problem, before the rescore.\n+\n+   * - ``original_weighted_possible``\n+     - number\n+     - The weighted maximum possible score for the problem, before the rescore.\n+\n+   * - ``problem_id``\n+     - string\n+     - The identifier for the problem in the form of a serialized usage key.\n+\n+\n+The ``edx.grades.problem.rescored`` event also includes the following\n+``event`` member fields, which serve the same purpose for this event as it\n+does for the :ref:`edx_grades_course_grade_calculated` event.","path":"en_us/data/source/internal_data_formats/tracking_logs.rst","position":132,"original_position":132,"commit_id":"4b79f5bcd759e86b791cfa55d755d18693a06339","original_commit_id":"cd8a7f23730088b7c9da5f914610547d50939e87","user":{"login":"catong","id":9041399,"avatar_url":"https://avatars.githubusercontent.com/u/9041399?v=3","gravatar_id":"","url":"https://api.github.com/users/catong","html_url":"https://github.com/catong","followers_url":"https://api.github.com/users/catong/followers","following_url":"https://api.github.com/users/catong/following{/other_user}","gists_url":"https://api.github.com/users/catong/gists{/gist_id}","starred_url":"https://api.github.com/users/catong/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/catong/subscriptions","organizations_url":"https://api.github.com/users/catong/orgs","repos_url":"https://api.github.com/users/catong/repos","events_url":"https://api.github.com/users/catong/events{/privacy}","received_events_url":"https://api.github.com/users/catong/received_events","type":"User","site_admin":false},"body":"Yep, it was an agreement problem caused by cutting and pasting.","created_at":"2016-12-13T16:13:19Z","updated_at":"2016-12-13T16:13:19Z","html_url":"https://github.com/edx/edx-documentation/pull/1353#discussion_r92202877","pull_request_url":"https://api.github.com/repos/edx/edx-documentation/pulls/1353","_links":{"self":{"href":"https://api.github.com/repos/edx/edx-documentation/pulls/comments/92202877"},"html":{"href":"https://github.com/edx/edx-documentation/pull/1353#discussion_r92202877"},"pull_request":{"href":"https://api.github.com/repos/edx/edx-documentation/pulls/1353"}}},"pull_request":{"url":"https://api.github.com/repos/edx/edx-documentation/pulls/1353","id":94895328,"html_url":"https://github.com/edx/edx-documentation/pull/1353","diff_url":"https://github.com/edx/edx-documentation/pull/1353.diff","patch_url":"https://github.com/edx/edx-documentation/pull/1353.patch","issue_url":"https://api.github.com/repos/edx/edx-documentation/issues/1353","number":1353,"state":"open","locked":false,"title":"DOC-3484 Add new grading events to Research Guide (WIP)","user":{"login":"catong","id":9041399,"avatar_url":"https://avatars.githubusercontent.com/u/9041399?v=3","gravatar_id":"","url":"https://api.github.com/users/catong","html_url":"https://github.com/catong","followers_url":"https://api.github.com/users/catong/followers","following_url":"https://api.github.com/users/catong/following{/other_user}","gists_url":"https://api.github.com/users/catong/gists{/gist_id}","starred_url":"https://api.github.com/users/catong/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/catong/subscriptions","organizations_url":"https://api.github.com/users/catong/orgs","repos_url":"https://api.github.com/users/catong/repos","events_url":"https://api.github.com/users/catong/events{/privacy}","received_events_url":"https://api.github.com/users/catong/received_events","type":"User","site_admin":false},"body":"## [DOC-3484](https://openedx.atlassian.net/browse/DOC-3484)\r\n\r\nThis PR adds new grading-related events to the Research Guide. The new events are described on this wiki page: https://openedx.atlassian.net/wiki/pages/viewpage.action?pageId=125927581\r\n\r\n### DRAFT HTML Version for Reviewing \r\n\r\nhttp://draftresearch-guide-gradingevents.readthedocs.io/en/latest/internal_data_formats/tracking_logs.html#grading-events\r\n\r\n### Reviewers\r\n\r\nPossible roles follow. The PR submitter checks the boxes after each reviewer finishes and gives :+1:. \r\n\r\n- [ ] Subject matter expert: @sanfordstudent \r\n- [ ] Subject matter expert: @nasthagiri \r\n- [x] Subject matter expert: @stroilova \r\n- [ ] Doc team review: @srpearce \r\n- [ ] Product review: @katymyw\r\n- [ ] Product review: @sstack22 \r\n\r\nFYI @jaakana, @macfarlane\r\n\r\n### Testing\r\n\r\n- [x] Ran ./run_tests.sh without warnings or errors\r\n\r\n\r\n\r\n### Post-review\r\n\r\n- [ ] Add a comment with the description of this change or link this PR to the next release notes task.\r\n- [ ] Squash commits\r\n\r\n\r\n","created_at":"2016-11-22T20:49:38Z","updated_at":"2016-12-13T16:13:19Z","closed_at":null,"merged_at":null,"merge_commit_sha":"33bc520435d4815a04815324a45ed0ab7e1e6b81","assignee":null,"assignees":[],"milestone":null,"commits_url":"https://api.github.com/repos/edx/edx-documentation/pulls/1353/commits","review_comments_url":"https://api.github.com/repos/edx/edx-documentation/pulls/1353/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/1353/comments","statuses_url":"https://api.github.com/repos/edx/edx-documentation/statuses/4b79f5bcd759e86b791cfa55d755d18693a06339","head":{"label":"edx:carol/DOC-3484GradingEvents","ref":"carol/DOC-3484GradingEvents","sha":"4b79f5bcd759e86b791cfa55d755d18693a06339","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":"For published versions of the edX documentation, visit:","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}","deployments_url":"https://api.github.com/repos/edx/edx-documentation/deployments","created_at":"2014-09-09T15:29:04Z","updated_at":"2016-10-24T13:29:38Z","pushed_at":"2016-12-13T15:46:00Z","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":" http://docs.edx.org","size":112767,"stargazers_count":52,"watchers_count":52,"language":"Makefile","has_issues":true,"has_downloads":true,"has_wiki":false,"has_pages":true,"forks_count":152,"mirror_url":null,"open_issues_count":20,"forks":152,"open_issues":20,"watchers":52,"default_branch":"master"}},"base":{"label":"edx:master","ref":"master","sha":"ab976657e22d7c126f66c289d3927918645b072a","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":"For published versions of the edX documentation, visit:","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}","deployments_url":"https://api.github.com/repos/edx/edx-documentation/deployments","created_at":"2014-09-09T15:29:04Z","updated_at":"2016-10-24T13:29:38Z","pushed_at":"2016-12-13T15:46:00Z","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":" http://docs.edx.org","size":112767,"stargazers_count":52,"watchers_count":52,"language":"Makefile","has_issues":true,"has_downloads":true,"has_wiki":false,"has_pages":true,"forks_count":152,"mirror_url":null,"open_issues_count":20,"forks":152,"open_issues":20,"watchers":52,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/edx/edx-documentation/pulls/1353"},"html":{"href":"https://github.com/edx/edx-documentation/pull/1353"},"issue":{"href":"https://api.github.com/repos/edx/edx-documentation/issues/1353"},"comments":{"href":"https://api.github.com/repos/edx/edx-documentation/issues/1353/comments"},"review_comments":{"href":"https://api.github.com/repos/edx/edx-documentation/pulls/1353/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/1353/commits"},"statuses":{"href":"https://api.github.com/repos/edx/edx-documentation/statuses/4b79f5bcd759e86b791cfa55d755d18693a06339"}}}}
{"actor":{"display_login":"catong"}}