GitHub PullRequestReviewCommentEvent at 2014-10-01 20:48:15
Repository: edx-platform
Actor: lamagnifica
Payload: {"action":"created","comment":{"url":"https://api.github.com/repos/edx/edx-platform/pulls/comments/18306815","id":18306815,"diff_hunk":"@@ -0,0 +1,274 @@\n+.. _Enabling and Configuring Cohorts:\n+\n+############################################\n+Enabling and Configuring the Cohort Feature\n+############################################\n+\n+To support private discussions for cohorts of students, you select a strategy\n+for assigning your students to cohort groups: automated assignment, manual\n+assignment, or a hybrid approach. See :ref:`Options for Assigning Students to\n+Cohorts`. You also decide whether to open any of the course-wide discussion\n+topics to participation by all students. \n+\n+After you select a strategy, you complete these steps (as applicable):\n+\n+#. :ref:`Enable the cohort feature<Enable Cohorts>`.\n+\n+#. Based on the strategy you select for assigning students to cohort groups:\n+   \n+  * :ref:`Enable automated cohort assignment<Enable Automated Cohort\n+    Assignment>` and\n+    :ref:`define the auto cohort groups<Define Auto Cohort Groups>`.\n+\n+  * :ref:`Define manual cohort groups<Define the Manual Cohort Groups>` and\n+    :ref:`assign students to them<Assign Students to Cohort Groups Manually>`.\n+\n+  * Do both. \n+\n+3. :ref:`Identify the course-wide discussion topics<Identifying Private\n+   CourseWide Discussion Topics>` that you want to support private, cohort-only\n+   participation. This procedure is optional.\n+\n+You complete these procedures in Studio and on the Instructor Dashboard. For an\n+optimal student experience, configuration of the cohort feature should be as\n+complete as possible prior to the start date of your course.\n+\n+.. _Enable Cohorts:\n+\n+********************************\n+Enabling the Cohort Feature\n+********************************\n+\n+#. Open the course in Studio. \n+\n+#. Select **Settings**, then **Advanced Settings**.\n+\n+#. In the **Cohort Configuration** field, place your cursor between the\n+   supplied pair of braces.\n+\n+#. Type ``\"cohorted\": true``. \n+\n+#. Click **Save Changes**. Studio reformats the name:value pair you just\n+   entered to indent it on a new line.\n+   \n+ .. image:: ../Images/Enable_cohorts.png\n+  :alt: Cohort Configuration dictionary field with the cohorted key defined \n+        as true\n+\n+.. _Implementing the Automated Assignment Strategy:\n+\n+***************************************************\n+Implementing the Automated Assignment Strategy\n+***************************************************\n+\n+To implement automated assignment of students to cohort groups you add two more\n+values to the **Cohort Configuration** advanced setting field.\n+\n+You complete these procedures if you are using either the automated or hybrid\n+assignment strategy for your course. For more information, see :ref:`All\n+Automated Assignment` or :ref:`Hybrid Assignment`.\n+\n+.. _Enable Automated Cohort Assignment:\n+\n+============================================\n+Enable Automated Cohort Assignment\n+============================================\n+\n+#. Open the course in Studio. \n+\n+#. Select **Settings**, then **Advanced Settings**.\n+\n+#. In the **Cohort Configuration** field, place your cursor after\n+   ``\"cohorted\": true``.\n+\n+#. Type a comma ``,`` character and then press Enter.\n+\n+#. Type ``\"auto_cohort\": true``. \n+\n+#. Click **Save Changes**. Studio resequences and reformats the name:value\n+   pairs.\n+\n+ .. image:: ../Images/Enable_auto_cohorts.png\n+  :alt: Cohort Configuration dictionary field with the auto_cohort key defined \n+        as true\n+\n+You continue by defining the auto cohort groups. \n+\n+.. _Define Auto Cohort Groups:\n+\n+============================================\n+Define the Auto Cohort Groups\n+============================================\n+\n+.. note:: Students can see the name of the cohort group they are assigned to. \n+ The message \"This post is visible only to Group *cohort name*\" appears with\n+ each post in discussion topics that support private, cohort-only\n+ participation.\n+\n+#. Open the course in Studio. \n+\n+#. Select **Settings**, then **Advanced Settings**.\n+\n+#. In the **Cohort Configuration** field, place your cursor after\n+   ``\"auto_cohort\": true,`` and then press Enter.\n+\n+#. For a fully automated assignment strategy, you define a set of groups. Place\n+   each group name within quotation marks, separate the names with commas, and\n+   place each one on a new line:\n+   \n+ .. code:: \n+\n+   \"auto_cohort_groups\": [\n+       \"example_1st_group_name\",\n+       \"example_2nd_group_name\",\n+       \"example_3rd_group_name\"\n+   ],\n+\n+.. here to alow indented formatting of next line only\n+\n+  For a hybrid strategy, you only define a single group. Type\n+   ``\"auto_cohort_groups\": [\"example_group_name\"]`` and then press Enter again.\n+\n+5. Click **Save Changes**. Studio resequences and reformats your entry.\n+\n+ .. image:: ../Images/Multiple_auto_cohort_groups.png\n+  :alt: Cohort Configuration dictionary field with the auto_cohort_groups key \n+        with one value\n+\n+.. spacer line\n+\n+ .. image:: ../Images/Single_auto_cohort_group.png\n+  :alt: Cohort Configuration dictionary field with the auto_cohort_groups key \n+        with one value\n+\n+When students who are not already assigned to a cohort group visit the\n+**Discussion** page, they are randomly assigned to an auto cohort group.\n+\n+.. _Implementing the Manual Assignment Strategy:\n+\n+***************************************************\n+Implementing the Manual Assignment Strategy\n+***************************************************\n+\n+To implement manual assignment of students to cohort groups, you define the\n+manual cohort groups and then assign students to them. You complete these\n+procedures if you are using either the manual or hybrid assignment strategy for\n+your course. For more information, see :ref:`All Manual Assignment` or\n+:ref:`Hybrid Assignment`.\n+\n+You must :ref:`enable the cohort feature<Enable Cohorts>` for your course\n+before you can complete these procedures.\n+\n+.. _Define the Manual Cohort Groups:\n+\n+==========================================\n+Define the Manual Cohort Groups\n+==========================================\n+\n+.. note:: Students can see the name of the cohort group they are assigned to. \n+ The message \"This post is visible only to Group *cohort name*\" appears with\n+ each post in discussion topics that support private, cohort-only\n+ participation.\n+\n+#. In your live course, select the **Instructor** page. \n+\n+#. On the **Membership** page, scroll to the **Cohort Group Management**\n+   section at the bottom.\n+\n+#. Click **Add Cohort Group**.\n+\n+#. Supply a name for the group, and then click **Add Cohort Group** below the\n+   **Cohort Name** field.\n+\n+.. question to Brian about same label on two different buttons\n+\n+.. _Assign Students to Cohort Groups Manually:\n+\n+==========================================\n+Assign Students to Cohort Groups Manually\n+==========================================\n+\n+#. In your live course, select the **Instructor** page. ","path":"docs/en_us/course_authors/source/cohorts/cohort_config.rst","position":191,"original_position":191,"commit_id":"de6c47805231c3e76a4441ec61c3b4d47d432907","original_commit_id":"de6c47805231c3e76a4441ec61c3b4d47d432907","user":{"login":"lamagnifica","id":6392274,"avatar_url":"https://avatars.githubusercontent.com/u/6392274?v=2","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":"restated\r\n","created_at":"2014-10-01T20:48:15Z","updated_at":"2014-10-01T20:48:15Z","html_url":"https://github.com/edx/edx-platform/pull/5327#discussion_r18306815","pull_request_url":"https://api.github.com/repos/edx/edx-platform/pulls/5327","_links":{"self":{"href":"https://api.github.com/repos/edx/edx-platform/pulls/comments/18306815"},"html":{"href":"https://github.com/edx/edx-platform/pull/5327#discussion_r18306815"},"pull_request":{"href":"https://api.github.com/repos/edx/edx-platform/pulls/5327"}}},"pull_request":{"url":"https://api.github.com/repos/edx/edx-platform/pulls/5327","id":21611844,"html_url":"https://github.com/edx/edx-platform/pull/5327","diff_url":"https://github.com/edx/edx-platform/pull/5327.diff","patch_url":"https://github.com/edx/edx-platform/pull/5327.patch","issue_url":"https://api.github.com/repos/edx/edx-platform/issues/5327","number":5327,"state":"open","locked":false,"title":"Ahodges/doc/cohorts","user":{"login":"lamagnifica","id":6392274,"avatar_url":"https://avatars.githubusercontent.com/u/6392274?v=2","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":"@explorerleslie , @nasthagiri , @andy-armstrong , @gwprice , @jimabramson , @dan-f , @cahrens, @srpearce  , @WatsonEmily , @mhoeber \r\nThe cohorts/cohort_config and cohorts/cohorts_overview files and images are pretty solid. Questions occasionally in comments.\r\nI'll work on the section describing moderating discussions in a cohorted universe next.","created_at":"2014-09-22T21:50:26Z","updated_at":"2014-10-01T20:48:15Z","closed_at":null,"merged_at":null,"merge_commit_sha":"434a252d42ac68ba9fe5c90ae12b618a104d1610","assignee":null,"milestone":null,"commits_url":"https://api.github.com/repos/edx/edx-platform/pulls/5327/commits","review_comments_url":"https://api.github.com/repos/edx/edx-platform/pulls/5327/comments","review_comment_url":"https://api.github.com/repos/edx/edx-platform/pulls/comments/{number}","comments_url":"https://api.github.com/repos/edx/edx-platform/issues/5327/comments","statuses_url":"https://api.github.com/repos/edx/edx-platform/statuses/de6c47805231c3e76a4441ec61c3b4d47d432907","head":{"label":"edx:ahodges/doc/cohorts","ref":"ahodges/doc/cohorts","sha":"de6c47805231c3e76a4441ec61c3b4d47d432907","user":{"login":"edx","id":3179841,"avatar_url":"https://avatars.githubusercontent.com/u/3179841?v=2","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":10391073,"name":"edx-platform","full_name":"edx/edx-platform","owner":{"login":"edx","id":3179841,"avatar_url":"https://avatars.githubusercontent.com/u/3179841?v=2","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-platform","description":"Open edX, the edX platform that powers http://edx.org","fork":false,"url":"https://api.github.com/repos/edx/edx-platform","forks_url":"https://api.github.com/repos/edx/edx-platform/forks","keys_url":"https://api.github.com/repos/edx/edx-platform/keys{/key_id}","collaborators_url":"https://api.github.com/repos/edx/edx-platform/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/edx/edx-platform/teams","hooks_url":"https://api.github.com/repos/edx/edx-platform/hooks","issue_events_url":"https://api.github.com/repos/edx/edx-platform/issues/events{/number}","events_url":"https://api.github.com/repos/edx/edx-platform/events","assignees_url":"https://api.github.com/repos/edx/edx-platform/assignees{/user}","branches_url":"https://api.github.com/repos/edx/edx-platform/branches{/branch}","tags_url":"https://api.github.com/repos/edx/edx-platform/tags","blobs_url":"https://api.github.com/repos/edx/edx-platform/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/edx/edx-platform/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/edx/edx-platform/git/refs{/sha}","trees_url":"https://api.github.com/repos/edx/edx-platform/git/trees{/sha}","statuses_url":"https://api.github.com/repos/edx/edx-platform/statuses/{sha}","languages_url":"https://api.github.com/repos/edx/edx-platform/languages","stargazers_url":"https://api.github.com/repos/edx/edx-platform/stargazers","contributors_url":"https://api.github.com/repos/edx/edx-platform/contributors","subscribers_url":"https://api.github.com/repos/edx/edx-platform/subscribers","subscription_url":"https://api.github.com/repos/edx/edx-platform/subscription","commits_url":"https://api.github.com/repos/edx/edx-platform/commits{/sha}","git_commits_url":"https://api.github.com/repos/edx/edx-platform/git/commits{/sha}","comments_url":"https://api.github.com/repos/edx/edx-platform/comments{/number}","issue_comment_url":"https://api.github.com/repos/edx/edx-platform/issues/comments/{number}","contents_url":"https://api.github.com/repos/edx/edx-platform/contents/{+path}","compare_url":"https://api.github.com/repos/edx/edx-platform/compare/{base}...{head}","merges_url":"https://api.github.com/repos/edx/edx-platform/merges","archive_url":"https://api.github.com/repos/edx/edx-platform/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/edx/edx-platform/downloads","issues_url":"https://api.github.com/repos/edx/edx-platform/issues{/number}","pulls_url":"https://api.github.com/repos/edx/edx-platform/pulls{/number}","milestones_url":"https://api.github.com/repos/edx/edx-platform/milestones{/number}","notifications_url":"https://api.github.com/repos/edx/edx-platform/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/edx/edx-platform/labels{/name}","releases_url":"https://api.github.com/repos/edx/edx-platform/releases{/id}","created_at":"2013-05-30T20:20:38Z","updated_at":"2014-10-01T20:18:06Z","pushed_at":"2014-10-01T20:46:28Z","git_url":"git://github.com/edx/edx-platform.git","ssh_url":"git@github.com:edx/edx-platform.git","clone_url":"https://github.com/edx/edx-platform.git","svn_url":"https://github.com/edx/edx-platform","homepage":"http://openedx.org/","size":1638592,"stargazers_count":1444,"watchers_count":1444,"language":"Python","has_issues":false,"has_downloads":true,"has_wiki":true,"has_pages":true,"forks_count":827,"mirror_url":null,"open_issues_count":101,"forks":827,"open_issues":101,"watchers":1444,"default_branch":"master"}},"base":{"label":"edx:master","ref":"master","sha":"874c3381757ad2bc455200a43cca507e7a57dc3e","user":{"login":"edx","id":3179841,"avatar_url":"https://avatars.githubusercontent.com/u/3179841?v=2","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":10391073,"name":"edx-platform","full_name":"edx/edx-platform","owner":{"login":"edx","id":3179841,"avatar_url":"https://avatars.githubusercontent.com/u/3179841?v=2","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-platform","description":"Open edX, the edX platform that powers http://edx.org","fork":false,"url":"https://api.github.com/repos/edx/edx-platform","forks_url":"https://api.github.com/repos/edx/edx-platform/forks","keys_url":"https://api.github.com/repos/edx/edx-platform/keys{/key_id}","collaborators_url":"https://api.github.com/repos/edx/edx-platform/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/edx/edx-platform/teams","hooks_url":"https://api.github.com/repos/edx/edx-platform/hooks","issue_events_url":"https://api.github.com/repos/edx/edx-platform/issues/events{/number}","events_url":"https://api.github.com/repos/edx/edx-platform/events","assignees_url":"https://api.github.com/repos/edx/edx-platform/assignees{/user}","branches_url":"https://api.github.com/repos/edx/edx-platform/branches{/branch}","tags_url":"https://api.github.com/repos/edx/edx-platform/tags","blobs_url":"https://api.github.com/repos/edx/edx-platform/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/edx/edx-platform/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/edx/edx-platform/git/refs{/sha}","trees_url":"https://api.github.com/repos/edx/edx-platform/git/trees{/sha}","statuses_url":"https://api.github.com/repos/edx/edx-platform/statuses/{sha}","languages_url":"https://api.github.com/repos/edx/edx-platform/languages","stargazers_url":"https://api.github.com/repos/edx/edx-platform/stargazers","contributors_url":"https://api.github.com/repos/edx/edx-platform/contributors","subscribers_url":"https://api.github.com/repos/edx/edx-platform/subscribers","subscription_url":"https://api.github.com/repos/edx/edx-platform/subscription","commits_url":"https://api.github.com/repos/edx/edx-platform/commits{/sha}","git_commits_url":"https://api.github.com/repos/edx/edx-platform/git/commits{/sha}","comments_url":"https://api.github.com/repos/edx/edx-platform/comments{/number}","issue_comment_url":"https://api.github.com/repos/edx/edx-platform/issues/comments/{number}","contents_url":"https://api.github.com/repos/edx/edx-platform/contents/{+path}","compare_url":"https://api.github.com/repos/edx/edx-platform/compare/{base}...{head}","merges_url":"https://api.github.com/repos/edx/edx-platform/merges","archive_url":"https://api.github.com/repos/edx/edx-platform/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/edx/edx-platform/downloads","issues_url":"https://api.github.com/repos/edx/edx-platform/issues{/number}","pulls_url":"https://api.github.com/repos/edx/edx-platform/pulls{/number}","milestones_url":"https://api.github.com/repos/edx/edx-platform/milestones{/number}","notifications_url":"https://api.github.com/repos/edx/edx-platform/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/edx/edx-platform/labels{/name}","releases_url":"https://api.github.com/repos/edx/edx-platform/releases{/id}","created_at":"2013-05-30T20:20:38Z","updated_at":"2014-10-01T20:18:06Z","pushed_at":"2014-10-01T20:46:28Z","git_url":"git://github.com/edx/edx-platform.git","ssh_url":"git@github.com:edx/edx-platform.git","clone_url":"https://github.com/edx/edx-platform.git","svn_url":"https://github.com/edx/edx-platform","homepage":"http://openedx.org/","size":1638592,"stargazers_count":1444,"watchers_count":1444,"language":"Python","has_issues":false,"has_downloads":true,"has_wiki":true,"has_pages":true,"forks_count":827,"mirror_url":null,"open_issues_count":101,"forks":827,"open_issues":101,"watchers":1444,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/edx/edx-platform/pulls/5327"},"html":{"href":"https://github.com/edx/edx-platform/pull/5327"},"issue":{"href":"https://api.github.com/repos/edx/edx-platform/issues/5327"},"comments":{"href":"https://api.github.com/repos/edx/edx-platform/issues/5327/comments"},"review_comments":{"href":"https://api.github.com/repos/edx/edx-platform/pulls/5327/comments"},"review_comment":{"href":"https://api.github.com/repos/edx/edx-platform/pulls/comments/{number}"},"commits":{"href":"https://api.github.com/repos/edx/edx-platform/pulls/5327/commits"},"statuses":{"href":"https://api.github.com/repos/edx/edx-platform/statuses/de6c47805231c3e76a4441ec61c3b4d47d432907"}}}}