{"action":"created","comment":{"url":"https://api.github.com/repos/edx/edx-documentation/pulls/comments/39109344","id":39109344,"diff_hunk":"@@ -0,0 +1,300 @@\n+.. _Teams Setup:\n+\n+##########################################\n+Using Teams in Your Courses\n+##########################################\n+\n+This section provides conceptual and procedural information about using teams\n+in your courses.\n+\n+\n+.. contents::\n+  :local:\n+  :depth: 2\n+\n+\n+.. _CA_Teams_Overview:\n+\n+*******************************\n+Teams Overview\n+*******************************\n+\n+Using teams in your course is an effective way for learners to interact and\n+collaborate on small group projects or activities. You can define a variety of\n+topics from learners to choose from, within which teams can be formed. Teams\n+must be formed within a topic.\n+\n+After browsing topics, learners can join a team or create their own team\n+within a topic. When learners create a new team, they add names and\n+descriptions to identify them but also, optionally, a primary communication\n+language and a primary country that members identify with. Team\n+characteristics might serve as the basis for attracting new members, resulting\n+in small groups of learners with similar interests and goals who will work\n+together on projects or activities within the same topic area.\n+\n+Teams are most effective when learners have a clear reason for joining a team,\n+and a clear outcome to achieve with fellow team members. For example, you\n+might create an assignment that consists of a group project or activity, with\n+a choice of topics, and ask learners to join teams within the topic of their\n+choice to complete the assignment. Team members can use the discussion forums","path":"en_us/shared/building_and_running_chapters/teams/teams_setup.rst","position":39,"original_position":39,"commit_id":"87a53bbe110918263fdca8405b8527682c490861","original_commit_id":"87a53bbe110918263fdca8405b8527682c490861","user":{"login":"explorerleslie","id":5643426,"avatar_url":"https://avatars.githubusercontent.com/u/5643426?v=3","gravatar_id":"","url":"https://api.github.com/users/explorerleslie","html_url":"https://github.com/explorerleslie","followers_url":"https://api.github.com/users/explorerleslie/followers","following_url":"https://api.github.com/users/explorerleslie/following{/other_user}","gists_url":"https://api.github.com/users/explorerleslie/gists{/gist_id}","starred_url":"https://api.github.com/users/explorerleslie/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/explorerleslie/subscriptions","organizations_url":"https://api.github.com/users/explorerleslie/orgs","repos_url":"https://api.github.com/users/explorerleslie/repos","events_url":"https://api.github.com/users/explorerleslie/events{/privacy}","received_events_url":"https://api.github.com/users/explorerleslie/received_events","type":"User","site_admin":false},"body":"do we use \"discussion forums\" or just \"discussions\" in the doc? I've always gone with \"discussions\" because that's what the tab says, but I don't know if we have a standard.","created_at":"2015-09-09T23:22:15Z","updated_at":"2015-09-09T23:22:15Z","html_url":"https://github.com/edx/edx-documentation/pull/538#discussion_r39109344","pull_request_url":"https://api.github.com/repos/edx/edx-documentation/pulls/538","_links":{"self":{"href":"https://api.github.com/repos/edx/edx-documentation/pulls/comments/39109344"},"html":{"href":"https://github.com/edx/edx-documentation/pull/538#discussion_r39109344"},"pull_request":{"href":"https://api.github.com/repos/edx/edx-documentation/pulls/538"}}},"pull_request":{"url":"https://api.github.com/repos/edx/edx-documentation/pulls/538","id":44468751,"html_url":"https://github.com/edx/edx-documentation/pull/538","diff_url":"https://github.com/edx/edx-documentation/pull/538.diff","patch_url":"https://github.com/edx/edx-documentation/pull/538.patch","issue_url":"https://api.github.com/repos/edx/edx-documentation/issues/538","number":538,"state":"open","locked":false,"title":"New PR for DOC: Course team documentation for teams feature","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":"\r\nhttps://openedx.atlassian.net/browse/DOC-1977\r\n\r\nThis PR includes course team documentation for teams, for the \"Building and Running an edX Course\" guide. **NOTE: screenshots are not yet final.\r\nThis PR replaces https://github.com/edx/edx-documentation/pull/476, which was accidentally merged. Review comments from the old PR will be brought over.\r\n\r\nThis feature will be in next week's release, Sept 9. Documentation will not be published on docs.edx.org, but will be shared with PMs and course teams for the teams pilot.\r\n\r\n### Reviewers\r\nCheck the appropriate box after each reviewer finishes and gives :+1:.\r\n- [ ] Subject matter expert: @dan-f \r\n- [ ] Subject matter expert: @andy-armstrong \r\n- [ ] Doc team review: @lamagnifica or @srpearce \r\n- [ ] Product review: @explorerleslie \r\n- [ ] PM review: Alison Kuryla\r\n- FYI: @symbolist and team, Melanie MacFarlane\r\n\r\n### Draft HTML Documentation\r\n- [x] http://draft-course-author-teams.readthedocs.org/en/latest/teams/index.html\r\n\r\n### Post-review\r\n- [ ] Squash commits\r\n\r\n","created_at":"2015-09-08T18:51:38Z","updated_at":"2015-09-09T23:22:15Z","closed_at":null,"merged_at":null,"merge_commit_sha":"116c5b8da57d9e536b2b83691f7e5c225f6c2e2d","assignee":null,"milestone":null,"commits_url":"https://api.github.com/repos/edx/edx-documentation/pulls/538/commits","review_comments_url":"https://api.github.com/repos/edx/edx-documentation/pulls/538/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/538/comments","statuses_url":"https://api.github.com/repos/edx/edx-documentation/statuses/87a53bbe110918263fdca8405b8527682c490861","head":{"label":"edx:carol/doc/CA_TEAMS2","ref":"carol/doc/CA_TEAMS2","sha":"87a53bbe110918263fdca8405b8527682c490861","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-08-28T01:43:53Z","pushed_at":"2015-09-09T21:06:49Z","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":88965,"stargazers_count":21,"watchers_count":21,"language":"Makefile","has_issues":true,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":82,"mirror_url":null,"open_issues_count":26,"forks":82,"open_issues":26,"watchers":21,"default_branch":"master"}},"base":{"label":"edx:master","ref":"master","sha":"e529515039d54a151827cf1275e9ddaba110b128","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-08-28T01:43:53Z","pushed_at":"2015-09-09T21:06:49Z","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":88965,"stargazers_count":21,"watchers_count":21,"language":"Makefile","has_issues":true,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":82,"mirror_url":null,"open_issues_count":26,"forks":82,"open_issues":26,"watchers":21,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/edx/edx-documentation/pulls/538"},"html":{"href":"https://github.com/edx/edx-documentation/pull/538"},"issue":{"href":"https://api.github.com/repos/edx/edx-documentation/issues/538"},"comments":{"href":"https://api.github.com/repos/edx/edx-documentation/issues/538/comments"},"review_comments":{"href":"https://api.github.com/repos/edx/edx-documentation/pulls/538/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/538/commits"},"statuses":{"href":"https://api.github.com/repos/edx/edx-documentation/statuses/87a53bbe110918263fdca8405b8527682c490861"}}}}