GitHub PullRequestReviewCommentEvent at 2014-10-01 17:04:47
Repository: edx-platform
Actor: lamagnifica
Payload: {"action":"created","comment":{"url":"https://api.github.com/repos/edx/edx-platform/pulls/comments/18292219","id":18292219,"diff_hunk":"@@ -0,0 +1,177 @@\n+.. _Cohorts Overview:\n+\n+##########################################\n+Using Cohorts to Build Course Communities\n+##########################################\n+\n+Cohorts create smaller communities of students within a course. Students who\n+are in a cohort can communicate and share experiences privately within course\n+discussion topics.\n+\n+When you decide to use cohorts in your course:\n+\n+* Discussion topics are either open to participation by all students, or\n+  divided to support private interactions among the members of each cohort. See\n+  :ref:`Options for Discussion Topics`.\n+\n+* Each student is in one and only one cohort. See :ref:`Options for Assigning\n+  Students to Cohorts`.\n+\n+* Every student must be in a cohort. This assures that every student has the\n+  ability to read and contribute to every discussion topic.\n+\n+To provide a consistent experience throughout the course run, each student's\n+assignment to a cohort should remain unchanged after the course begins.\n+\n+For more information, see:\n+\n+* :ref:`Enabling and Configuring Cohorts`\n+\n+* :ref:`Moderating Discussions for Cohorts`\n+\n+For more information about discussions, see :ref:`Discussions`.\n+\n+.. _Options for Discussion Topics:\n+\n+*********************************\n+Options for Discussion Topics\n+*********************************\n+\n+By enabling the cohort feature in a course, you provide students with the\n+ability to ask questions of, and have conversations with, other members of\n+their own cohorts. Through these proviate discussions, cohort feature can help\n+students develop a sense of community, provide specialized experiences, and\n+encourage deeper, more meaningful course involvement.\n+\n+Enabling the cohort feature has the following effects on the discussion topics\n+in the course.\n+\n+* All of the content-specific discussion topics are configured to support\n+  private interactions, among the members of each cohort only. A student who is\n+  assigned to one cohort group cannot read or add to the posts, responses, or\n+  comments contributed by the members of another cohort group.\n+\n+  You cannot change the configuration of these topics. You create content-\n+  specific discussion topics in a course by adding units that include\n+  discussion components.\n+\n+* All of the course-wide discussion topics are, by default, open to all of the\n+  students in the course, regardless of their cohort group assignments. All\n+  students can post, read, respond, and comment in these topics without regard\n+  to cohort.\n+\n+  You can configure course-wide discussion topics to support private\n+  interactions among the members of the cohort groups. For example, you might\n+  decide to keep the topics that you set up for Troubleshooting, Feedback, and\n+  Frequently Asked Questions open to all students, but change the General\n+  discussion topic so that it supports conversations that are specific to the\n+  members of each cohort. You create course-wide discussion topics on the\n+  **Advanced Settings** page in Studio.\n+\n+For more information about course-wide and content-specific discussion topics,\n+see :ref:`Organizing_discussions`.\n+\n+.. _Options for Assigning Students to Cohorts:\n+\n+*****************************************\n+Options for Assigning Students to Cohorts\n+*****************************************\n+\n+After you enable the cohort feature, you can configure it so that students are\n+assigned to their cohorts automatically or manually. You can also use a\n+combination of both assignment methods. Typically, your purpose in using the\n+cohort feature determines which assignment option you will use for your course.\n+\n+.. note:: When you choose to include the cohort feature in a course, all \n+ enrolled students must be assigned to a cohort.\n+\n+.. _All Automated Assignment:\n+\n+=============================================================\n+Making MOOC Discussions Manageable: All Automated Assignment\n+=============================================================\n+\n+In very large courses, the number of posts made to course discussion topics can\n+make for a daunting amount of daily reading. In such courses, dividing the\n+enrollees into separate cohorts makes the volume of posts, responses, and\n+comments by the members of each one more manageable, and is more likely to\n+foster community feeling.\n+\n+To implement this assignment strategy, you enable the cohort feature and create\n+a set of \"auto\" cohort groups. The first time a student visits the course\n+**Discussion** page, he or she is randomly assigned to one of the cohort\n+groups. Together, all of the students assigned to a group are a cohort.\n+\n+.. Greg I expect I am oversimplifying this, Is it a visit to any discussion topic as well as the Discussion page?\n+\n+Based on the experiences of MOOC teams that have used the cohort feature in\n+this way, these guidelines are suggested to help you determine how many auto\n+cohort groups to define for your course.\n+\n+* Out of every 10,000 students who enroll, approximately 200 to 400 students\n+  are active in the discussions.\n+\n+* Divide the estimated total enrollment of the course run by 10,000.\n+\n+* Use the result as the number of auto cohort groups to create.\n+\n+For example, two days before it starts a course has an enrollment of 80,000\n+students. To create small communities within the discussions, the course team\n+enables the cohort feature with automated assignment, and creates eight auto\n+cohort groups. As they visit the **Discussion** page, students are assigned to","path":"docs/en_us/course_authors/source/cohorts/cohorts_overview.rst","position":121,"original_position":121,"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":"making sure I understand: @zhkramer 's scenario, that he's asking for a clarification or warning about, will no longer occur. TNL-160 added the concept of a default cohort so that no students remain unassigned. Is that correct, @explorerleslie ?\r\n","created_at":"2014-10-01T17:04:47Z","updated_at":"2014-10-01T17:04:47Z","html_url":"https://github.com/edx/edx-platform/pull/5327#discussion_r18292219","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/18292219"},"html":{"href":"https://github.com/edx/edx-platform/pull/5327#discussion_r18292219"},"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-01T17:04:47Z","closed_at":null,"merged_at":null,"merge_commit_sha":"5ad2369c459fa9ff91f7bb2d38363699486fa753","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-01T14:40:15Z","pushed_at":"2014-10-01T16:46:40Z","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":1442,"watchers_count":1442,"language":"Python","has_issues":false,"has_downloads":true,"has_wiki":true,"has_pages":true,"forks_count":827,"mirror_url":null,"open_issues_count":104,"forks":827,"open_issues":104,"watchers":1442,"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-01T14:40:15Z","pushed_at":"2014-10-01T16:46:40Z","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":1442,"watchers_count":1442,"language":"Python","has_issues":false,"has_downloads":true,"has_wiki":true,"has_pages":true,"forks_count":827,"mirror_url":null,"open_issues_count":104,"forks":827,"open_issues":104,"watchers":1442,"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"}}}}