{"action":"created","comment":{"url":"https://api.github.com/repos/edx/edx-documentation/pulls/comments/22981673","id":22981673,"diff_hunk":"@@ -0,0 +1,281 @@\n+.. _Randomized Content Blocks:\n+\n+#########################\n+Randomized Content Blocks\n+#########################\n+\n+If your course has :ref:`content libraries<Content Libraries>` enabled and you\n+have access to a library whose content you want to use, you can reference that\n+library to create a randomized assignments for students. \n+\n+To create a randomized assignment, you add one or more randomized content blocks\n+to a course unit. For each randomized content block, specify one or more\n+libraries from which the content is drawn, and indicate the number and\n+optionally the type of problem that each student is randomly given. If you\n+specify more than one library from which to randomly draw components for the\n+randomized assignment, the content from all specified libraries is combined\n+before the random selection is made.\n+\n+The libraries that you create or have access to are listed on the **Libraries**\n+tab on the Studio Home page. For details about content libraries, see\n+:ref:`Content Libraries`.\n+\n+For details about using content library components in a course, see these\n+topics:\n+\n+* :ref:`Use Components from Libraries in a Course`\n+* :ref:`Add a Randomized Content Block to Your Course`\n+* :ref:`View the Matching Components in a Randomized Content Block`\n+* :ref:`Edit Components in Randomized Content Blocks`\n+* :ref:`Get the Latest Version of Library Content`\n+\n+\n+.. _Use Components from Libraries in a Course:\n+\n+*****************************************\n+Use Components from Libraries in a Course\n+*****************************************\n+\n+To create randomized assignments that make use of components from content\n+libraries, you must have at least **User** level access to the libraries that\n+you want to use. If you do not have access to a library, members of your course\n+team who have **Admin** access to that library can grant you access.\n+\n+The libraries that you create or have access to are listed on the **Libraries**\n+tab on the Studio Home page. For details about content libraries, see\n+:ref:`Content Libraries`.\n+\n+Using components from content libraries in your course involves two steps.\n+\n+#. :ref:`Enable Content Libraries`\n+#. :ref:`Add a Randomized Content Block to Your Course`\n+   \n+.. note:: After adding a randomized content block to your course, be aware that\n+   if components in the source library or libraries change, you must manually\n+   update the components in the course outline if you want to keep the components\n+   synchronized with the version in the library.\n+\n+For details about working with randomized content blocks in your course, see\n+these topics.\n+\n+* :ref:`View the Matching Components in a Randomized Content Block`\n+* :ref:`Edit Components in Randomized Content Blocks`\n+* :ref:`Get the Latest Version of Library Content`\n+\n+\n+.. _Enable Content Libraries:\n+\n+========================\n+Enable Content Libraries\n+========================\n+\n+You must enable content libraries before you can use randomized components from\n+:ref:`content libraries<Content Libraries>` in your courses.\n+\n+#. In Studio, open the course in which you want to provide library content.\n+\n+#. Select **Settings**, then **Advanced Settings**.\n+\n+#. In the **Advanced Module List** field, place your cursor between the\n+   supplied pair of square brackets.\n+\n+#. Type ``\"library_content\"``. \n+\n+#. Click **Save Changes**. \n+   \n+   Studio reformats the policy key you just entered to indent it on a new line.\n+\n+  .. image:: ../Images/ContentLibraries_AdvancedSetting.png\n+     :alt: Advanced Module policy key \"library_content\"\n+\n+\n+.. _Add a Randomized Content Block to Your Course:\n+\n+=============================================\n+Add a Randomized Content Block to Your Course   \n+=============================================\n+\n+After you :ref:`enable content libraries<Enable Content Libraries>` you can add\n+library content to your courses using the Randomized Content Block advanced\n+component.\n+\n+.. note:: Before starting these steps, obtain the Library ID for each library\n+   that you intend to reference in the randomized content block. The Library ID\n+   is found in the sidebar of each library's page. For details, see :ref:`Create\n+   a New Library`.\n+\n+#. In Studio, open the course in which you want to add randomized problems from\n+   one or more content libraries.\n+\n+#. Click **Content** then click **Outline**.\n+\n+#. In the unit where you want to add a set of randomized problems, click **Add\n+   New Component** \n+\n+#. Click **Advanced**, then click **Randomized Content Block**.\n+   The randomized content block is added to your unit.\n+\n+#. Click the **Edit** icon.\n+   \n+#. In the randomized content block settings, specify the details of the content\n+   you want to add in this block.\n+\n+  - For **Count**, enter the number of problems to display to each student.\n+\n+  - For **Display Name**, enter the name that you want students to see for this\n+    block.\n+\n+  - For **Libraries**, enter the unique Library ID found in the sidebar of\n+    the Library page in Studio. To select problems from more than one content\n+    library, click **Add** to enter each additional Library ID.\n+\n+  - For **Problem Type**, from the drop down list select a specific type of\n+    problem to be drawn from the library or libraries. Select **Any Type**\n+    if you do not want to select a particular type of problem.\n+\n+    .. image:: ../Images/ContentLibraries_SelectProblemType.png\n+     :alt: The Edit icon to the right of the Library Name    \n+\n+  - For **Scored**, from the drop down list select **True** or **False** to\n+    indicate whether the assignment should be graded. \n+\n+.. note:: Grading is subject to the setting of this unit's subsection or\n+   section. If the subsection or section is not graded, selecting **True** here has\n+   no impact. Selecting **False** means that this assignment is not graded even if\n+   the subsection or section is graded.\n+\n+7. Click **Save** when you have finished specifying the details of your\n+   randomized content block.\n+\n+To view the list of components in the source library that match your filter\n+settings, see :ref:`View the Matching Components in a Randomized Content Block`.\n+\n+To view the entire contents of the library in Studio, see :ref:`View the\n+Contents of a Library`.\n+   \n+\n+.. _View the Matching Components in a Randomized Content Block:\n+\n+***********************************************************\n+View the Matching Components in a Randomized Content Block","path":"en_us/shared/exercises_tools/randomized_content_blocks.rst","position":160,"original_position":160,"commit_id":"8b59a11f6aa5d0b445b6953c2f276741e308d23f","original_commit_id":"f0ba1da16c7bef580bba92a38cff44bfb5f84f7d","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":"As per above, and this definitely isn't essential, the only filter that this seems to apply is \"problem type\". Problem types aren't synonymous with components. What seems to be offered here is a useful report of the library content that the course will actually deliver to students. I'm just not sure I understand the purpose or thinking behind it to offer suggestions for a more accurate title.\r\nMaybe \r\nPreview RCB Problems\r\n?\r\n","created_at":"2015-01-15T00:03:39Z","updated_at":"2015-01-15T00:03:39Z","html_url":"https://github.com/edx/edx-documentation/pull/102#discussion_r22981673","pull_request_url":"https://api.github.com/repos/edx/edx-documentation/pulls/102","_links":{"self":{"href":"https://api.github.com/repos/edx/edx-documentation/pulls/comments/22981673"},"html":{"href":"https://github.com/edx/edx-documentation/pull/102#discussion_r22981673"},"pull_request":{"href":"https://api.github.com/repos/edx/edx-documentation/pulls/102"}}},"pull_request":{"url":"https://api.github.com/repos/edx/edx-documentation/pulls/102","id":27385638,"html_url":"https://github.com/edx/edx-documentation/pull/102","diff_url":"https://github.com/edx/edx-documentation/pull/102.diff","patch_url":"https://github.com/edx/edx-documentation/pull/102.patch","issue_url":"https://api.github.com/repos/edx/edx-documentation/issues/102","number":102,"state":"open","locked":false,"title":"Content libraries doc ","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":"This PR is the new version of  https://github.com/edx/edx-documentation/pull/93 -- needed to merge to DOCS/SaudiProjects rather than master.\r\n\r\n@antoviaque @marcotuts @bradenmacdonald @lamagnifica @mhoeber -- please review.\r\nThis 2nd draft includes these changes:\r\n\r\n- incorporated review comments\r\n - restructured the content to separate information for 2 audiences: 1) that the library creation piece is in \"Creating Course Content\", and 2) the use of randomized content blocks in course outline is covered under \"Creating Exercises and Tools\" > \"Randomized Content Blocks\".\r\n - adds a note in the Content Libraries overview that content libraries are only supported for courses with the particular course ID format that indicates use of split mongo.\r\n\r\nUpdated HTML is here: http://draft-library-doc-test.readthedocs.org/en/latest/creating_content/libraries.html\r\n","created_at":"2015-01-14T21:37:35Z","updated_at":"2015-01-15T00:03:39Z","closed_at":null,"merged_at":null,"merge_commit_sha":"664e89fab6d24d00053a501f21ef7eabab9d149a","assignee":null,"milestone":null,"commits_url":"https://api.github.com/repos/edx/edx-documentation/pulls/102/commits","review_comments_url":"https://api.github.com/repos/edx/edx-documentation/pulls/102/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/102/comments","statuses_url":"https://api.github.com/repos/edx/edx-documentation/statuses/8b59a11f6aa5d0b445b6953c2f276741e308d23f","head":{"label":"edx:carol/docs/Libraries_CA","ref":"carol/docs/Libraries_CA","sha":"8b59a11f6aa5d0b445b6953c2f276741e308d23f","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-01-14T21:57:34Z","pushed_at":"2015-01-14T23:43:50Z","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":55262,"stargazers_count":7,"watchers_count":7,"language":"CSS","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":15,"mirror_url":null,"open_issues_count":12,"forks":15,"open_issues":12,"watchers":7,"default_branch":"master"}},"base":{"label":"edx:DOCS/SaudiProjects","ref":"DOCS/SaudiProjects","sha":"41703b3e1e7f4295f7c30f36343e2105bfef155b","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-01-14T21:57:34Z","pushed_at":"2015-01-14T23:43:50Z","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":55262,"stargazers_count":7,"watchers_count":7,"language":"CSS","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":15,"mirror_url":null,"open_issues_count":12,"forks":15,"open_issues":12,"watchers":7,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/edx/edx-documentation/pulls/102"},"html":{"href":"https://github.com/edx/edx-documentation/pull/102"},"issue":{"href":"https://api.github.com/repos/edx/edx-documentation/issues/102"},"comments":{"href":"https://api.github.com/repos/edx/edx-documentation/issues/102/comments"},"review_comments":{"href":"https://api.github.com/repos/edx/edx-documentation/pulls/102/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/102/commits"},"statuses":{"href":"https://api.github.com/repos/edx/edx-documentation/statuses/8b59a11f6aa5d0b445b6953c2f276741e308d23f"}}}}