{"action":"created","comment":{"url":"https://api.github.com/repos/edx/edx-documentation/pulls/comments/22916787","id":22916787,"diff_hunk":"@@ -0,0 +1,550 @@\n+.. _Content Libraries:\n+\n+##################\n+Content Libraries \n+##################\n+\n+In Studio, use content libraries to build a pool of components that can be\n+shared across multiple courses to create randomized assessments. You can add\n+HTML components, problems, and video components to a library. Peer assessment\n+and discussion components are not supported in randomized content blocks.\n+\n+Create randomized assessments in your course by adding a randomized content\n+block to a unit, and specifying the number and type of problems that each\n+student is assigned, to be drawn from the specified content libraries. If you\n+specify more than one library from which to randomly draw components for the\n+randomized assessment, 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.\n+\n+See the following sections for details about creating and managing content\n+libraries.\n+\n+* :ref:`Enable the Library Content Feature`\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 Contents of 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+To create a new :ref:`library<Content Libraries>`, follow these steps.\n+\n+#. Log in to Studio.\n+#. Click **New Library**.\n+#. Enter mandatory information for your new library, then click **Create**.\n+\n+  .. image:: ../Images/ContentLibrary_NewCL.png\n+     :alt: Image of the library creation page\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+.. note:: Enter new library information carefully. After you create a new\n+     library, you cannot delete it. The Library Code becomes part of the URL\n+     for your library.   \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 is shown 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:: You might want to copy or make a note of the Library ID for the    new\n+   library. When you add a randomized content block to a course unit, you use\n+   the Library ID to specify this library as a source for the randomized\n+   content.\n+\n+\n+.. _Edit a Library:\n+\n+**************\n+Edit a Library\n+**************\n+\n+After you create a new library, the only change you can make to the initial\n+library information is to the name. However, at any time, you can make changes\n+to the components in your library, including adding or deleting components, and\n+editing the settings of components.\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+For details about editing the contents of a library, refer to :ref:`Edit\n+Components in a Library`. See also :ref:`Add Components to a Library` and\n+:ref:`Delete a 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 various types of components, see 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, which are\n+retained when the component is selected from the library and used in a course.\n+Within a course, you can further edit the component settings or revert to the\n+library settings. For details, refer to :ref:`Edit Components in a Library` and\n+:ref:`Get the Latest Version of Library Content`.\n+\n+\n+.. _View the Contents of a Library:\n+\n+******************************\n+View the Contents of a Library\n+******************************\n+\n+To view the entire contents of a library in Studio, follow these steps.\n+\n+#. Log in to Studio.\n+#. Click **Libraries**, then click the library whose components you want to\n+   view.\n+\n+The components in the library are displayed in the order in which they were\n+added, with the most recently added at the bottom. Each page shows up to 10\n+components. If your library has more than 10 components, additional components\n+are shown on other pages.\n+\n+The range of the components shown on the current page, and the total number of\n+components, are shown at the top of the page.\n+\n+You can navigate through the pages in these ways:\n+\n+* Use the **<** and **>** buttons at the top and bottom of the list to navigate\n+  to the previous and next pages.\n+\n+* At the bottom of the page, you can edit the first number in the page range.\n+  Click the number to place your cursor in the field, then enter the page number\n+  you want to jump to.\n+\n+  .. image:: ../Images/file_pagination.png\n+     :alt: Image showing a pair of page numbers with the first number circled\n+\n+To view the list of matching components in the library, see :ref:`View the\n+Matching Contents of a Randomized Content Block`.\n+\n+To view the randomized content as a student would see it, see :ref:`View the\n+Randomized Content as a Student`.\n+\n+\n+.. _Edit Components in a Library:\n+\n+****************************\n+Edit Components in a Library\n+****************************\n+\n+You can perform the same tasks with components in a library as you can with\n+components that you have added to a course. \n+\n+For step-by-step instructions for editing, duplicating, or deleting components,\n+refer to the following topics:\n+\n+* :ref:`Edit a Component`\n+* :ref:`Duplicate a Component`\n+* :ref:`Delete a Component`\n+\n+.. note:: If you modify components in your library that are in use in a course,\n+   including deleting components, these updates in the \"source\" library are not\n+   reflected in the course unless you manually update the randomized content\n+   block in the course outline. For details about updating library components\n+   used in your course to match the latest version in the content library, see\n+   :ref:`Get the Latest Version of Library Content`.\n+\n+\n+.. _Delete a Library:\n+\n+*****************\n+Delete a Library\n+*****************\n+\n+You cannot delete a library after creating it. Instead, you can simply\n+discontinue use of an unwanted library. To do so, first make sure that none of\n+its components are in use in any courses, then delete all components in the\n+library. You can also :ref:`edit the name of the library<Edit a Library>` to\n+make it clear to other course staff that the library should not be referenced in\n+courses.\n+\n+For details about deleting components in a library, see :ref:`Edit Components in\n+a Library`.\n+\n+\n+.. _Give Other Users Access to Your Library:\n+\n+***************************************\n+Give Other Users Access to Your Library\n+***************************************\n+\n+You can give other Studio users access to your library. Depending on their role,\n+additional library users can view and use library content in courses, edit\n+library content, or add and manage other library users. All course team members\n+must be registered with Studio and have an active account.","path":"en_us/course_authors/source/developing_course/libraries.rst","position":240,"original_position":238,"commit_id":"29427bb58803a587059bdb6cdd86e18b8d6c6e7c","original_commit_id":"7a1e9b4d993579f03512fb348b72ce3009e8178e","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":"Thanks, good note about who can create a library.","created_at":"2015-01-14T04:47:59Z","updated_at":"2015-01-14T04:47:59Z","html_url":"https://github.com/edx/edx-documentation/pull/93#discussion_r22916787","pull_request_url":"https://api.github.com/repos/edx/edx-documentation/pulls/93","_links":{"self":{"href":"https://api.github.com/repos/edx/edx-documentation/pulls/comments/22916787"},"html":{"href":"https://github.com/edx/edx-documentation/pull/93#discussion_r22916787"},"pull_request":{"href":"https://api.github.com/repos/edx/edx-documentation/pulls/93"}}},"pull_request":{"url":"https://api.github.com/repos/edx/edx-documentation/pulls/93","id":27129115,"html_url":"https://github.com/edx/edx-documentation/pull/93","diff_url":"https://github.com/edx/edx-documentation/pull/93.diff","patch_url":"https://github.com/edx/edx-documentation/pull/93.patch","issue_url":"https://api.github.com/repos/edx/edx-documentation/issues/93","number":93,"state":"open","locked":false,"title":"Content Libraries: documentation","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 is the initial draft of documentation for the Content Library feature in the \"Building and Running a Course\" guide. \r\n@antoviaque @marcotuts  FYI @smagoun @mhoeber @srpearce @lamagnifica \r\nPlease flag anyone I've missed who might want to review.\r\nPlease review by EOD Monday Jan 12 (sorry for the short notice)!\r\n\r\nFor easier reading, here is an HTML version: \r\nhttp://draft-content-libraries.readthedocs.org/en/latest/developing_course/libraries.html\r\n","created_at":"2015-01-09T21:05:26Z","updated_at":"2015-01-14T04:47:59Z","closed_at":null,"merged_at":null,"merge_commit_sha":"aaa9b7bb841c99811ae553d33f21748a0c2f1813","assignee":null,"milestone":null,"commits_url":"https://api.github.com/repos/edx/edx-documentation/pulls/93/commits","review_comments_url":"https://api.github.com/repos/edx/edx-documentation/pulls/93/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/93/comments","statuses_url":"https://api.github.com/repos/edx/edx-documentation/statuses/29427bb58803a587059bdb6cdd86e18b8d6c6e7c","head":{"label":"edx:carol/docs/Libraries_CA","ref":"carol/docs/Libraries_CA","sha":"29427bb58803a587059bdb6cdd86e18b8d6c6e7c","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-13T14:24:02Z","pushed_at":"2015-01-13T22:24:54Z","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":6,"watchers_count":6,"language":"CSS","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":13,"mirror_url":null,"open_issues_count":11,"forks":13,"open_issues":11,"watchers":6,"default_branch":"master"}},"base":{"label":"edx:master","ref":"master","sha":"c6fb17a87467b6940ba3e4b7577470abef4265e0","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-13T14:24:02Z","pushed_at":"2015-01-13T22:24:54Z","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":6,"watchers_count":6,"language":"CSS","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":13,"mirror_url":null,"open_issues_count":11,"forks":13,"open_issues":11,"watchers":6,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/edx/edx-documentation/pulls/93"},"html":{"href":"https://github.com/edx/edx-documentation/pull/93"},"issue":{"href":"https://api.github.com/repos/edx/edx-documentation/issues/93"},"comments":{"href":"https://api.github.com/repos/edx/edx-documentation/issues/93/comments"},"review_comments":{"href":"https://api.github.com/repos/edx/edx-documentation/pulls/93/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/93/commits"},"statuses":{"href":"https://api.github.com/repos/edx/edx-documentation/statuses/29427bb58803a587059bdb6cdd86e18b8d6c6e7c"}}}}