{"action":"created","comment":{"url":"https://api.github.com/repos/edx/edx-documentation/pulls/comments/39543263","id":39543263,"diff_hunk":"@@ -0,0 +1,113 @@\n+.. _CA Learner Experience of Teams:\n+\n+\n+##########################################\n+The Learner's Experience of Teams \n+##########################################\n+\n+After you have :ref:`enabled teams <Teams Setup>` and created topics in your\n+course, learners can begin browsing topics and joining teams. Teams are formed\n+within topics. Each learner can belong to only one team.\n+\n+.. contents::\n+  :local:\n+  :depth: 1\n+\n+***********************************\n+Browsing Teams by Topic\n+***********************************\n+\n+On the **Teams** page in the LMS, learners in your course can browse topics to\n+find a subject that they are interested in collaborating on. Learners can sort\n+topics alphabetically by name, or by the number of teams in a topic.\n+\n+\n+.. image:: ../../../shared/building_and_running_chapters/Images/Teams_TopicArrowButton.png\n+  :width: 500\n+  :alt: On the page showing available topics, one topic has the arrow button\n+      that takes users to the list of teams within that topic highlighted.\n+\n+Within each topic, learners can view existing teams. The overview for each\n+team shows the team's name and description, the number of members and\n+available spots, and the elapsed time since the last activity in the team.\n+\n+To find teams, learners can sort teams by the most recent activity or by the\n+most open spots. They can also use keywords to search for teams that might\n+match their interests, language, or country.\n+\n+When learners locate a team that they might be interested in joining, they can\n+select **View** on the team overview to view team details.\n+\n+.. image:: ../../../shared/building_and_running_chapters/Images/Teams_TopicViewButton.png\n+  :width: 500\n+  :alt: View of a team within a topic showing name and description, number of members.\n+\n+On each team's details page, learners can view the team's name and\n+description, as well as optional characteristics that were specified: a\n+primary language of communication and a country that members primarily\n+identify with. While they are browsing teams, learners can read any team's\n+discussion posts, but they cannot add posts to a team's discussion forum\n+unless they join that team.\n+\n+\n+*************************************\n+Joining, Creating, or Leaving a Team\n+*************************************\n+\n+When learners find a team that they want to join, they select **Join Team**\n+and are immediately added to the team membership.\n+\n+.. note:: Learners can belong to only one team. If a learner already belongs to a\n+   team, the **Join Team** button is not available. \n+\n+Learners can create their own teams if they cannot find a team they want to\n+join. Under the list of existing teams in a topic, learners select **create a\n+new team in this topic**. This link is available only to learners who do not\n+already belong to a team.\n+\n+.. image:: ../../../shared/building_and_running_chapters/Images/Teams_CreateNewTeamLink.png\n+  :width: 500\n+  :alt: View of a team within a topic showing name and description, number of members.\n+\n+Learners specify a name and description for their team, and optionally specify\n+a country and language that team members identify with. A learner who creates\n+a team automatically becomes a member of the new team.\n+\n+.. note:: EdX recommends that you encourage learners to join existing teams\n+   before they create new teams.\n+\n+.. note:: Course team members who have the role of Admin, Discussion\n+   Moderator, or Discussion Admin can create multiple teams; therefore they\n+   are not automatically added to teams that they create. This is also true\n+   for learners who have the community TA role.\n+\n+At any time, learners can leave teams that they have joined, although you\n+should emphasize to learners that they should try not to change teams after\n+any team projects or activities have started. Learners who leave a team will\n+also be unable to continue contributing to discussion threads in the team that\n+they have left.\n+\n+Learners can only belong to one team at a time. For learners who already\n+belong to a team, the **Join Team** button is not available when they view\n+other teams. To join a new team, they must first leave their existing team.","path":"en_us/shared/building_and_running_chapters/teams/teams_learner_experience.rst","position":92,"original_position":92,"commit_id":"d42caafcabf1597fc425028cdd465233c1c71023","original_commit_id":"4ef664c9b907550c81ab28d8afd53c9277a57451","user":{"login":"srpearce","id":3493253,"avatar_url":"https://avatars.githubusercontent.com/u/3493253?v=3","gravatar_id":"","url":"https://api.github.com/users/srpearce","html_url":"https://github.com/srpearce","followers_url":"https://api.github.com/users/srpearce/followers","following_url":"https://api.github.com/users/srpearce/following{/other_user}","gists_url":"https://api.github.com/users/srpearce/gists{/gist_id}","starred_url":"https://api.github.com/users/srpearce/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/srpearce/subscriptions","organizations_url":"https://api.github.com/users/srpearce/orgs","repos_url":"https://api.github.com/users/srpearce/repos","events_url":"https://api.github.com/users/srpearce/events{/privacy}","received_events_url":"https://api.github.com/users/srpearce/received_events","type":"User","site_admin":false},"body":"I feel like you've already covered the info in this paragraph (except for having to leave the existing team, which you could add to one of the other places you mention this). I'd delete it.","created_at":"2015-09-15T17:57:48Z","updated_at":"2015-09-15T17:57:48Z","html_url":"https://github.com/edx/edx-documentation/pull/538#discussion_r39543263","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/39543263"},"html":{"href":"https://github.com/edx/edx-documentation/pull/538#discussion_r39543263"},"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-15T17:57:48Z","closed_at":null,"merged_at":null,"merge_commit_sha":"f637d9ffae7ccbb64ecc13c3ea4f43d0509c4354","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/d42caafcabf1597fc425028cdd465233c1c71023","head":{"label":"edx:carol/doc/CA_TEAMS2","ref":"carol/doc/CA_TEAMS2","sha":"d42caafcabf1597fc425028cdd465233c1c71023","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-09-14T07:02:46Z","pushed_at":"2015-09-15T17:51:45Z","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":89956,"stargazers_count":22,"watchers_count":22,"language":"Makefile","has_issues":true,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":84,"mirror_url":null,"open_issues_count":29,"forks":84,"open_issues":29,"watchers":22,"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-09-14T07:02:46Z","pushed_at":"2015-09-15T17:51:45Z","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":89956,"stargazers_count":22,"watchers_count":22,"language":"Makefile","has_issues":true,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":84,"mirror_url":null,"open_issues_count":29,"forks":84,"open_issues":29,"watchers":22,"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/d42caafcabf1597fc425028cdd465233c1c71023"}}}}