{"action":"created","comment":{"url":"https://api.github.com/repos/edx/edx-documentation/pulls/comments/22980227","id":22980227,"diff_hunk":"@@ -0,0 +1,396 @@\n+.. _Content Libraries:\n+\n+##############################\n+Working with Content Libraries \n+##############################\n+\n+\n+.. _ Content Libraries Overview:\n+\n+**************************\n+Content Libraries Overview\n+**************************\n+\n+In Studio, if you have course creation privileges, you can create a content\n+library to build a pool of components that can be used in randomized assignments\n+in your courses. You can add HTML components, problems, and video components to\n+a library. Peer assessment and discussion components are not supported in\n+content libraries.\n+\n+.. note:: Content libraries are available only with courses whose course\n+   identifiers are in this format: ``{key type}:{org}+{course}+{run}``. For\n+   example, ``course-v1:edX+DemoX+Demo_2015``.\n+\n+After creating a library and adding components to it, if you have :ref:`enabled\n+content libraries<Enable Content Libraries>` in your course, you can use these\n+library components in randomized assignments in your course. You do this by\n+adding a randomized content block to a course unit and indicating one or more\n+libraries from which the randomized content is to drawn, as well as the number\n+and type of problems that each student is assigned. If you specify more than one\n+library from which to randomly draw components for the randomized assignment,\n+the content from all specified libraries is combined before the random selection\n+is made.\n+\n+Libraries have separate users and levels of access from courses. Initially, only\n+the person who created the library has access. She can add other users to the\n+library. For details, see :ref:`Give Other Users Access to Your Library`. The\n+libraries that you create or have access to are listed on the **Libraries** tab\n+on the Studio Home page.\n+\n+See the following sections for details about creating and managing content\n+libraries.\n+\n+* :ref:`Enable Content Libraries`\n+* :ref:`Create a New Library`\n+* :ref:`Add Components to a Library`\n+* :ref:`View the Contents of a Library`\n+* :ref:`Edit Components in a Library`\n+* :ref:`Give Other Users Access to Your Library`\n+\n+See the following sections for details about using content library components in\n+a course.\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+.. _Create a New Library:\n+\n+********************\n+Create a New Library\n+********************\n+\n+Use :ref:`content libraries<Content Libraries>` to build a pool of components\n+that can be used in randomized assignments in your courses. You can create\n+content libraries if you have course creation privileges.\n+\n+For information about adding other users to a library after you create it, see\n+:ref:`Give Other Users Access to Your Library`.\n+\n+To create a new content library, follow these steps.\n+\n+#. Log in to Studio. \n+   \n+#. Click **New Library**. \n+#. Enter the required information for your new library, then click **Create**.\n+\n+   .. note:: Enter new library information carefully. After you create a\n+      new library, you cannot delete it. The Library Code becomes part of the\n+      URL for your library, therefore the total number of characters in the\n+      **Library Name**, **Organization**, and **Library Code** fields must be 65\n+      or fewer.\n+\n+   .. image:: ../Images/ContentLibrary_NewCL.png\n+      :alt: Image of the library creation page\n+\n+\n+  * For **Library Name**, enter the public display name for your library. Choose\n+    a meaningful name that will help you and other course team members to\n+    identify the contents of the library. For example, \"Level 200 Math\n+    Problems\".\n+\n+  * For **Organization**, enter the identifier for your university. For\n+    example, enter HarvardX or MITx. Do not include spaces or special\n+    characters.\n+\n+  * For **Library Code**, enter an identifier for your library that is unique\n+    within your organization. This code becomes part of the URL for your\n+    library, so do not include spaces or special characters in the code.\n+\n+\n+4. Click **Create**.\n+\n+You see the new library, to which you can now add components. For details about\n+adding components to a library, see :ref:`Add Components to a Library`.\n+\n+The system-generated Library ID for the new library appears in the sidebar.\n+\n+  .. image:: ../Images/ContentLibraryID.png\n+     :alt: The Library ID for the new library is shown the sidebar\n+\n+.. note:: Copy or make a note of the Library ID for the new library. When you\n+   add a randomized content block to a course unit, you use the Library ID to\n+   specify this library as a source for the randomized content.\n+\n+\n+.. _Edit a Library:\n+\n+**************\n+Edit a Library\n+**************\n+\n+After you create a library, the only change you can make to the initial library\n+information is to the name. However, at any time, you can make changes to the\n+components in your library, including adding or deleting components or editing\n+the settings of components. For details about editing the contents of a library,\n+see :ref:`Edit Components in a Library` and :ref:`Add Components to a Library`.\n+\n+\n+To change the name of a library, follow these steps.\n+\n+#. Log in to Studio.\n+#. Click **Libraries**, then click the library whose name you want to edit.\n+   \n+#. Click the **Edit** icon next to the library name. \n+   \n+   The library name field becomes editable.\n+   \n+  .. image:: ../Images/ContentLibrary_EditName.png\n+     :alt: The Edit icon to the right of the Library Name\n+\n+4.  In the library name field, make edits or enter a new library name.\n+#. Click anywhere outside the library name field to save your changes.\n+\n+\n+For details about giving other users access to the library, see :ref:`Give Other\n+Users Access to Your Library`.\n+\n+\n+.. _Add Components to a Library:\n+\n+****************************\n+Add Components to a Library\n+****************************\n+\n+To add new :ref:`components<What is a Component>` to your library, follow these\n+steps.\n+\n+#. Log in to Studio.\n+#. Click **Libraries**, then click the library that you want to add components to.\n+\n+#. Click **Add Component**, then click the component type that you want to add\n+   under **Add New Component**.\n+\n+For more information about the types of components you can add to a library, see\n+these topics.\n+\n+* :ref:`Working with HTML Components`\n+* :ref:`Working with Problem Components`\n+* :ref:`Working with Video Components`\n+\n+After you add a component to a library, you can edit its settings. These\n+settings are retained when the component is selected from the library and used\n+in a course.\n+\n+After a component from the library is added to a unit within a randomized","path":"en_us/course_authors/source/creating_content/libraries.rst","position":178,"original_position":178,"commit_id":"f0ba1da16c7bef580bba92a38cff44bfb5f84f7d","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":"This makes it seem as though you can select a single component out of a library to add to your course. Is that correct? Or do you just reference an entire library in a RCB component, and add that to a unit, as indicated above?","created_at":"2015-01-14T23:31:04Z","updated_at":"2015-01-14T23:31:04Z","html_url":"https://github.com/edx/edx-documentation/pull/102#discussion_r22980227","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/22980227"},"html":{"href":"https://github.com/edx/edx-documentation/pull/102#discussion_r22980227"},"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-14T23:31:04Z","closed_at":null,"merged_at":null,"merge_commit_sha":"643268d37ecd6ebf3491de28263cc530355cfb04","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/f0ba1da16c7bef580bba92a38cff44bfb5f84f7d","head":{"label":"edx:carol/docs/Libraries_CA","ref":"carol/docs/Libraries_CA","sha":"f0ba1da16c7bef580bba92a38cff44bfb5f84f7d","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:21:48Z","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:21:48Z","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/f0ba1da16c7bef580bba92a38cff44bfb5f84f7d"}}}}