{"action":"created","comment":{"url":"https://api.github.com/repos/edx/edx-documentation/pulls/comments/22609616","id":22609616,"diff_hunk":"@@ -0,0 +1,224 @@\n+.. _Cohorted Courseware Overview:\n+\n+\n+#############################\n+Creating Cohorted Courseware\n+#############################\n+\n+If you have :ref:`cohort groups enabled<Enabling and Configuring Cohorts>` in\n+your course, you can create different course experiences for students in\n+different cohort groups.\n+\n+You can design your course so that students in one cohort group are given\n+different content than students in another cohort group. You do this by\n+associating one or more cohort groups with a cohorted content group, and\n+designating specific course components as visible to particular content groups.\n+Any course components that do not have an explicitly restricted visibility\n+setting remain visible to all students, regardless of their cohort group. For\n+more details about cohorted content groups, see :ref:`About Cohorted Content\n+Groups`.\n+\n+Complete these steps to create cohorted content in your course. Optionally, you\n+can transpose the order of steps 4 and 5.\n+\n+#. :ref:`Enable cohorts for your course<Enabling and Configuring Cohorts>`.\n+#. :ref:`Assign students to cohort groups<Options for Assigning Students to\n+   Cohorts>`. \n+#. :ref:`Create cohorted content groups in Studio<Creating Content Groups>`.\n+#. :ref:`Associate one or more cohort groups with a cohorted content\n+   group<Associate Cohort Groups with Content Groups>`.\n+#. In your course outline, :ref:`Specify Components in Courseware as Visible Only to Certain Content Groups`.\n+#. :ref:`View the Course as a Member of a Content Group`.\n+\n+\n+.. _Cohorted Courseware Example:\n+\n+********************************\n+Example: Cohorted Courseware\n+********************************\n+\n+You have four cohort groups in your course: A, B, and C. In one subsection in\n+your course, you want the students in cohort group A to see a video, while the\n+students in the remaining two cohort groups see a reading assignment. You want\n+to provide the same quiz to all students, regardless of cohort group, at the end\n+of that subsection.\n+\n+To achieve this, on the **Group Configurations** page in Studio, you create two\n+cohorted content groups, one called \"Video\" and the other called \"Reading\". In\n+the Instructor Dashboard, on the **Membership** tab, you associate cohort group\n+A with the \"Video\" content group, and you associate cohort groups B and C with\n+the \"Reading\" content group. Then, in your course outline, in the relevant\n+subsection, you edit the video component so that it is visible only to the\n+\"Video\" content group (which consists of cohort group A) and you edit the\n+reading assignment component so that it is visible only to the \"Reading\" content\n+group (which consists of cohort groups B and C). You do not need to edit the\n+visibility settings of the quiz component, because if no content group is\n+specified in a component's visibility settings, it is visible to all students.\n+\n+As a final step, in the Instructor Dashboard you preview the course to ensure\n+that students see the content that is intended for them. You view the course as\n+a member of each of the content groups to confirm that as a student in the\n+\"Video\" content group, you see a video and the final quiz but not the reading\n+assignment; and as a student in the \"Reading\" content group, you see a reading\n+assignment and the final quiz, but not a video.\n+\n+\n+.. _About Cohorted Content Groups:\n+\n+********************************\n+Cohorted Content Groups Overview\n+********************************\n+\n+Cohorted content groups, also referred to as content groups, are the means by\n+which you can designate specific course content as visible to particular cohort\n+groups of students. You create cohorted content groups and associate them with\n+one or more cohort groups, then indicate in your courseware when particular\n+content is visible to a content group. Each component in your course can be made\n+visible to one or more content groups.\n+\n+Any course components that do not have an explicitly restricted visibility\n+setting remain visible to all students, regardless of their cohort group.\n+\n+For an example of using content groups to create cohorted courseware, see\n+:ref:`Cohorted Courseware Example`.\n+\n+\n+.. _Creating Content Groups:\n+\n+******************************\n+Create Cohorted Content Groups\n+******************************\n+\n+#. In Studio, select **Settings** then select **Group Configurations**.\n+#. On the **Group Configurations** page, click **New cohorted content group**.\n+#. Enter a meaningful name for the content group, then click **Create**.\n+#. Repeat this step to create as many cohorted content groups as you want.\n+\n+After you create a content group, you can go to the Instructor Dashboard to\n+associate it with one or more cohort groups, or work with your course outline to\n+specify which components are visible to specific content groups.\n+\n+For details, see :ref:`Associate Cohort Groups with Content Groups` and\n+:ref:`Specify Components in Courseware as Visible Only to Certain Content Groups`.\n+\n+.. note:: Once a content group is created, you cannot delete it. You can\n+   remove the association between a cohorted content group and its cohort groups\n+   by associating it with another cohort group, or by changing the association\n+   to **Not Selected**.\n+\n+\n+.. _Associate Cohort Groups with Content Groups:\n+\n+************************************************\n+Associate Cohort Groups with Content Groups\n+************************************************\n+\n+After you have created a content group, you can associate it with one or more\n+cohort groups. You can use content groups to specify that components in your\n+course are visible only to students in the cohort group or groups associated\n+with content groups.","path":"en_us/course_authors/source/cohorts/cohorted_courseware.rst","position":119,"original_position":119,"commit_id":"a589a4999952d2ada8a0ca337d59d770d1188572","original_commit_id":"a589a4999952d2ada8a0ca337d59d770d1188572","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":"what are these groups associated with content groups? that sort of comes out of left field.","created_at":"2015-01-07T19:37:16Z","updated_at":"2015-01-07T19:37:16Z","html_url":"https://github.com/edx/edx-documentation/pull/87#discussion_r22609616","pull_request_url":"https://api.github.com/repos/edx/edx-documentation/pulls/87","_links":{"self":{"href":"https://api.github.com/repos/edx/edx-documentation/pulls/comments/22609616"},"html":{"href":"https://github.com/edx/edx-documentation/pull/87#discussion_r22609616"},"pull_request":{"href":"https://api.github.com/repos/edx/edx-documentation/pulls/87"}}},"pull_request":{"url":"https://api.github.com/repos/edx/edx-documentation/pulls/87","id":26801770,"html_url":"https://github.com/edx/edx-documentation/pull/87","diff_url":"https://github.com/edx/edx-documentation/pull/87.diff","patch_url":"https://github.com/edx/edx-documentation/pull/87.patch","issue_url":"https://api.github.com/repos/edx/edx-documentation/issues/87","number":87,"state":"open","locked":false,"title":"Cohorted Courseware carol/docs/CohortDOC-1222","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":"@explorerleslie @andy-armstrong @cahrens @dan-f @talbs @jimabramson \r\n@mhoeber @lamagnifica @srpearce \r\nThis is draft documentation for the cohorted courseware feature. Would like first round of review feedback by EOD Friday Jan 9, please.\r\nHTML output is here for easier viewing: http://draft-cohorted-courseware.readthedocs.org/en/latest/cohorts/cohorted_courseware.html\r\n\r\n","created_at":"2015-01-05T00:17:21Z","updated_at":"2015-01-07T19:37:16Z","closed_at":null,"merged_at":null,"merge_commit_sha":"7e37ac938a30a52e80a1896120165550d705b737","assignee":null,"milestone":null,"commits_url":"https://api.github.com/repos/edx/edx-documentation/pulls/87/commits","review_comments_url":"https://api.github.com/repos/edx/edx-documentation/pulls/87/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/87/comments","statuses_url":"https://api.github.com/repos/edx/edx-documentation/statuses/a589a4999952d2ada8a0ca337d59d770d1188572","head":{"label":"edx:carol/docs/CohortDOC-1222","ref":"carol/docs/CohortDOC-1222","sha":"a589a4999952d2ada8a0ca337d59d770d1188572","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-07T17:20:11Z","pushed_at":"2015-01-07T19:15:08Z","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":52916,"stargazers_count":6,"watchers_count":6,"language":"Makefile","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":12,"mirror_url":null,"open_issues_count":9,"forks":12,"open_issues":9,"watchers":6,"default_branch":"master"}},"base":{"label":"edx:master","ref":"master","sha":"5bcd95e85182a5756926c6bcd43155b310654e34","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-07T17:20:11Z","pushed_at":"2015-01-07T19:15:08Z","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":52916,"stargazers_count":6,"watchers_count":6,"language":"Makefile","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":12,"mirror_url":null,"open_issues_count":9,"forks":12,"open_issues":9,"watchers":6,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/edx/edx-documentation/pulls/87"},"html":{"href":"https://github.com/edx/edx-documentation/pull/87"},"issue":{"href":"https://api.github.com/repos/edx/edx-documentation/issues/87"},"comments":{"href":"https://api.github.com/repos/edx/edx-documentation/issues/87/comments"},"review_comments":{"href":"https://api.github.com/repos/edx/edx-documentation/pulls/87/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/87/commits"},"statuses":{"href":"https://api.github.com/repos/edx/edx-documentation/statuses/a589a4999952d2ada8a0ca337d59d770d1188572"}}}}