{"action":"created","comment":{"url":"https://api.github.com/repos/edx/edx-documentation/pulls/comments/26418757","id":26418757,"diff_hunk":"@@ -2199,6 +2204,151 @@ for a problem and it is graded successfully.\n        problems.\n \n \n+.. _library:\n+\n+==========================\n+Library Interaction Events\n+==========================\n+\n+Libraries identify and organize course content, such as a collection of\n+problem components for a particular subject. Libraries are created and\n+maintained separately from courses so that their content can be used by\n+different courses.\n+\n+In a course outline, course teams can include randomized content block\n+components that reference a library and deliver its content to students. In a\n+randomized content block component, the course team defines how many of the\n+library components to deliver to each student, and whether those components\n+are selected randomly or specified ahead of time.\n+\n+For more information, see \n+\n+.. xref to come from Carol\n+\n+``edx.librarycontentblock.content.assigned``\n+********************************************\n+\n+The server emits an ``edx.librarycontentblock.content.assigned`` event in the\n+following situations.\n+\n+* The first time that content from a randomized content block is delivered to\n+  a student, the server emits an ``edx.librarycontentblock.content.assigned``\n+  event. \n+\n+* If the course team changes the randomized content block after the initial\n+  user visit to increase the number of library components to deliver, the\n+  server emits another ``edx.librarycontentblock.content.assigned`` event when\n+  the user revisits the randomized content block or accesses the progress\n+  page.\n+\n+**Event Source**: Server\n+\n+**History** Added 17 Mar 2015.\n+\n+``event`` **Member Fields**:\n+\n+.. list-table::\n+   :widths: 15 15 60\n+   :header-rows: 1\n+\n+   * - Field\n+     - Type\n+     - Details\n+   * - ``added``\n+     - dictionary\n+     - Lists the library components delivered to the user for the first time.\n+       The content of this field is only different from the content of the\n+       ``result`` field in situations where the course team increased the\n+       number of components for the randomized content block to deliver.\n+   * - ``location``\n+     - string\n+     - Identifies the library. \n+   * - ``max_count``\n+     - integer\n+     - The **Count** specified by a course team member in Studio. Defines the\n+       number of library components to deliver. This number can be greater\n+       than the number of library components listed by the ``result`` field.\n+   * - ``previous_count``\n+     - integer\n+     - The content of this field is only different from the content of the\n+       ``max_count`` field in situations where the course team increased the\n+       number of components for the randomized content block to deliver.\n+   * - ``result``\n+     - dictionary\n+     - Lists all of the library components delivered to the user. \n+\n+       * ``descendants``, when present, is a dictionary that identifies each\n+         part of a library component that contains multiple parts (the\n+         children of an xblock with children).\n+\n+       * ``original_usage_key`` and ``original_usage_version`` identify the\n+         library component (the xblock in the library). \n+\n+         When students attempt a problem component delivered by a randomized\n+         content block, the resulting problem events also reference the\n+         ``original_usage_key`` and ``original_usage_version`` in\n+         ``context.module``  member fields. See :ref:`context`.\n+\n+       * ``usage_key`` identifies the randomized content block component (the\n+         xblock in the course).\n+       \n+       \n+``edx.librarycontentblock.content.removed``\n+*******************************************\n+\n+The server emits an ``edx.librarycontentblock.content.removed`` event only if\n+a course team makes the following changes to a running course.\n+\n+* If components are removed from the library and the course team\n+  resynchronizes the randomized content block to the library, the server emits\n+  an ``edx.librarycontentblock.content.removed`` event if a user revisits the","path":"en_us/data/source/internal_data_formats/tracking_logs.rst","position":144,"original_position":144,"commit_id":"caed6e2efdd909a5aec38d2c2ad45b29e80a6c36","original_commit_id":"caed6e2efdd909a5aec38d2c2ad45b29e80a6c36","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":"replace \"user\" with \"student\" or \"learner\"?","created_at":"2015-03-13T20:06:44Z","updated_at":"2015-03-13T20:06:44Z","html_url":"https://github.com/edx/edx-documentation/pull/208#discussion_r26418757","pull_request_url":"https://api.github.com/repos/edx/edx-documentation/pulls/208","_links":{"self":{"href":"https://api.github.com/repos/edx/edx-documentation/pulls/comments/26418757"},"html":{"href":"https://github.com/edx/edx-documentation/pull/208#discussion_r26418757"},"pull_request":{"href":"https://api.github.com/repos/edx/edx-documentation/pulls/208"}}},"pull_request":{"url":"https://api.github.com/repos/edx/edx-documentation/pulls/208","id":31073756,"html_url":"https://github.com/edx/edx-documentation/pull/208","diff_url":"https://github.com/edx/edx-documentation/pull/208.diff","patch_url":"https://github.com/edx/edx-documentation/pull/208.patch","issue_url":"https://api.github.com/repos/edx/edx-documentation/issues/208","number":208,"state":"open","locked":false,"title":"Ahodges/clibrary events","user":{"login":"lamagnifica","id":6392274,"avatar_url":"https://avatars.githubusercontent.com/u/6392274?v=3","gravatar_id":"","url":"https://api.github.com/users/lamagnifica","html_url":"https://github.com/lamagnifica","followers_url":"https://api.github.com/users/lamagnifica/followers","following_url":"https://api.github.com/users/lamagnifica/following{/other_user}","gists_url":"https://api.github.com/users/lamagnifica/gists{/gist_id}","starred_url":"https://api.github.com/users/lamagnifica/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/lamagnifica/subscriptions","organizations_url":"https://api.github.com/users/lamagnifica/orgs","repos_url":"https://api.github.com/users/lamagnifica/repos","events_url":"https://api.github.com/users/lamagnifica/events{/privacy}","received_events_url":"https://api.github.com/users/lamagnifica/received_events","type":"User","site_admin":false},"body":"@bradenmacdonald , @antoviaque , @marcotuts , @brianhw , @stroilova the description of the two new events is in the internal_data_formats/tracking_logs.rst file, under the \".. _library:\" marker. Please review for accuracy and completeness. Reviewing table-formatted text in rat files can be tedious, so the \"View\" button near the file name can be helpful.\r\n@catong, please review.","created_at":"2015-03-12T20:21:39Z","updated_at":"2015-03-13T20:06:44Z","closed_at":null,"merged_at":null,"merge_commit_sha":"6fec3da6155b8d3dc0ad6e6aa3c62c23b8c7459e","assignee":null,"milestone":null,"commits_url":"https://api.github.com/repos/edx/edx-documentation/pulls/208/commits","review_comments_url":"https://api.github.com/repos/edx/edx-documentation/pulls/208/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/208/comments","statuses_url":"https://api.github.com/repos/edx/edx-documentation/statuses/caed6e2efdd909a5aec38d2c2ad45b29e80a6c36","head":{"label":"edx:ahodges/clibrary_events","ref":"ahodges/clibrary_events","sha":"caed6e2efdd909a5aec38d2c2ad45b29e80a6c36","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-03-13T15:48:12Z","pushed_at":"2015-03-13T19:41:47Z","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":61908,"stargazers_count":10,"watchers_count":10,"language":"CSS","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":32,"mirror_url":null,"open_issues_count":11,"forks":32,"open_issues":11,"watchers":10,"default_branch":"master"}},"base":{"label":"edx:master","ref":"master","sha":"edc64378d6d4a461be7bf7f2d918463e45ce20ea","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-03-13T15:48:12Z","pushed_at":"2015-03-13T19:41:47Z","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":61908,"stargazers_count":10,"watchers_count":10,"language":"CSS","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":32,"mirror_url":null,"open_issues_count":11,"forks":32,"open_issues":11,"watchers":10,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/edx/edx-documentation/pulls/208"},"html":{"href":"https://github.com/edx/edx-documentation/pull/208"},"issue":{"href":"https://api.github.com/repos/edx/edx-documentation/issues/208"},"comments":{"href":"https://api.github.com/repos/edx/edx-documentation/issues/208/comments"},"review_comments":{"href":"https://api.github.com/repos/edx/edx-documentation/pulls/208/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/208/commits"},"statuses":{"href":"https://api.github.com/repos/edx/edx-documentation/statuses/caed6e2efdd909a5aec38d2c2ad45b29e80a6c36"}}}}