{"action":"created","comment":{"url":"https://api.github.com/repos/edx/edx-documentation/pulls/comments/75547829","id":75547829,"diff_hunk":"@@ -5,142 +5,109 @@\n Providing Feedback on Contributions\n ###############################################\n \n-This topic describes how to provide feedback on discussion contributions.\n+As you read the contributions that other learners and course team members make\n+to discussion topics, you can provide feedback in other ways than writing a\n+complete response or comment.\n \n .. contents::\n   :local:\n   :depth: 1\n \n-*********\n-Overview\n-*********\n+****************\n+Feedback Options\n+****************\n \n-As you read the contributions that other students and course team members make\n-to discussion topics, you can provide feedback without writing a complete\n-response or comment. You can:\n-\n-* :ref:`Vote for posts and responses<Vote for Posts or Responses>` to provide\n-  positive feedback.\n-\n-* :ref:`Follow posts<Follow Posts>` so that you can check back in on\n-  interesting conversations and questions easily.\n-\n-* :ref:`Answer questions, and mark your questions as answered<Answer\n-  Questions>`.\n-\n-* :ref:`Report a contribution<Report Discussion Misuse>` that is inappropriate\n-  to the course team.\n-\n-To select a feedback option, you use the icons at the top right of each post,\n-response, or comment. When you move your cursor over these icons a label\n-appears.\n+When you open a post, response, or comment, the **Vote** and **Follow**\n+feedback option icons appear at the top right. Move your cursor over these\n+icons to show the full label.\n \n .. image:: ../../../shared/students/Images/Discussion_options_mouseover.png\n- :width: 300\n- :alt: The icons at top right of a post, shown before the cursor is\n-      placed over each one and with the Vote, Follow, and More labels.\n+ :width: 120\n+ :alt: The \"Vote\", \"Follow\" and \"More\" feedback icons in a post, response, or\n+    comment.\n \n-When you select the \"More\" icon, a menu of available options opens. Options\n-vary depending on whether the contribution is a post, response, or comment, and\n-on whether you are a student or a member of the discussion team.\n+Select the \"More\" icon to show a menu of additional options. Options vary\n+depending on whether the contribution is a post, response, or comment, and on\n+whether you are a learner in the course, or a member of the discussion\n+moderation team.\n \n-.. image:: ../../../shared/students/Images/Discussion_More_menu.png\n- :width: 300\n- :alt: The More icon expanded to show a menu with one option and a menu with\n-       three options.\n \n .. _Vote for Posts or Responses:\n \n ************************************\n Vote for Posts or Responses\n ************************************\n \n-If you like a post or one of its responses, you can vote for it. Hover over the\n-plus sign (+) icon for the post or response, and then select **Vote**.\n-\n-.. image:: ../../../shared/students/Images/Disc_Vote.png\n- :width: 500\n- :alt: A post with the Vote icon circled.\n+To provide positive feedback for a post or one of its responses, you can vote\n+for it. Open the post or response, and select the plus sign (+) icon next to\n+the number of **Votes**.\n \n-You can sort the list of posts so that the posts with the most votes appear at\n-the top: select the drop-down list of sorting options and select **by most\n-votes**.\n+In the discussion navigation pane, you can sort the list of posts so that the\n+posts with the most votes appear at the top. To do this, select the drop-down\n+list of sorting options and select **by most votes**. For more information\n+about ways to sort the list of discussion topics, see :ref:`Read New or\n+Updated Posts`.\n \n-.. image:: ../../../shared/students/Images/Disc_SortByVotes.png\n- :width: 300\n- :alt: The list of posts with the \"by most votes\" sorting option and the\n-       number of votes for the post circled\n-\n-You can see the number of votes that each post has received in the list of\n-posts. (Votes for responses are not included in the number.)\n \n .. _Follow Posts:\n \n ************************************\n Follow Posts\n ************************************\n \n-If you find a post particularly interesting and want to return to it in the\n-future, you can follow it. To follow a post, hover over the star icon for the\n-post, and then select **Follow**.\n+If you find a convversation or question particularly interesting, you can\n+follow it so that you can return to it easily.\n \n-.. image:: ../../../shared/students/Images/Discussion_follow.png\n- :width: 500\n- :alt: A post with the Follow icon circled.\n+To follow a post, hover over the star icon for the post, and then select\n+**Follow**.\n \n Each post that you follow appears with a \"Following\" indicator in the list of\n posts.\n \n-To list only the posts that you are following, regardless of the discussion\n-topic they apply to, select the drop-down Discussion list and select **Posts\n-I'm Following**.\n+In the discussion navigation pane, you can list only the posts that you are\n+following, regardless of the discussion topic they apply to. To do this,\n+select **All Discussions** and then select **Posts I'm Following**.\n \n-.. image:: ../../../shared/students/Images/Disc_Following.png\n- :width: 300\n- :alt: The list of posts with the \"Posts I'm Following\" filter selected. Every\n-       post in the list shows the following indicator.\n \n .. _Answer Questions:\n \n ********************************************************\n Answer Questions and Mark Questions as Answered\n ********************************************************\n \n-Anyone in a course can answer questions. Just add a response with your answer\n-to the question post.\n-\n-You can indicate that a response to your own question post is the correct\n-answer. To do this, hover over the check mark icon for the response, and then\n-select **Mark as Answer**.\n+Anyone in a course can answer questions that are posted in the course\n+discussions. To respond to a question that has been asked by someone else in\n+the course, just add a response with your answer to the question post.\n \n-.. image:: ../../../shared/students/Images/Disc_AnswerQuestion.png\n- :width: 500\n- :alt: A question and a response, with the Mark as Answer icon circled.\n+If you have received a helpful or correct response to a question that you\n+yourself have asked, you can mark the response as the answer. To do this,\n+hover over the check mark icon for the response, and then select **Mark as\n+Answer**.\n \n-After at least one response is marked as the answer, a check or tick mark image\n-replaces the question mark image for the post in the discussion navigation\n-pane.\n+.. note:: The discussion moderation team can mark any response as correct.\n+   Learners can only mark responses as correct for their own posts.\n \n-.. image:: ../../../shared/students/Images/Disc_AnsweredInList.png\n- :width: 300\n- :alt: The list of posts with images identifying unanswered and answered\n-     questions and discussions.\n+After at least one response to a question post is marked as the answer, a\n+green check or tick mark image replaces the post's question mark indicator in","path":"en_us/shared/students/sfd_discussions/provide_feedback.rst","position":165,"original_position":165,"commit_id":"6638390a97ae633e55c937898ea0d48e07b11892","original_commit_id":"d2752e61d65a53cd66686ab4f2d36122f95d961c","user":{"login":"andy-armstrong","id":5985072,"avatar_url":"https://avatars.githubusercontent.com/u/5985072?v=3","gravatar_id":"","url":"https://api.github.com/users/andy-armstrong","html_url":"https://github.com/andy-armstrong","followers_url":"https://api.github.com/users/andy-armstrong/followers","following_url":"https://api.github.com/users/andy-armstrong/following{/other_user}","gists_url":"https://api.github.com/users/andy-armstrong/gists{/gist_id}","starred_url":"https://api.github.com/users/andy-armstrong/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/andy-armstrong/subscriptions","organizations_url":"https://api.github.com/users/andy-armstrong/orgs","repos_url":"https://api.github.com/users/andy-armstrong/repos","events_url":"https://api.github.com/users/andy-armstrong/events{/privacy}","received_events_url":"https://api.github.com/users/andy-armstrong/received_events","type":"User","site_admin":false},"body":"It isn't green anymore, right?","created_at":"2016-08-19T20:37:31Z","updated_at":"2016-08-19T20:37:31Z","html_url":"https://github.com/edx/edx-documentation/pull/1081#discussion_r75547829","pull_request_url":"https://api.github.com/repos/edx/edx-documentation/pulls/1081","_links":{"self":{"href":"https://api.github.com/repos/edx/edx-documentation/pulls/comments/75547829"},"html":{"href":"https://github.com/edx/edx-documentation/pull/1081#discussion_r75547829"},"pull_request":{"href":"https://api.github.com/repos/edx/edx-documentation/pulls/1081"}}},"pull_request":{"url":"https://api.github.com/repos/edx/edx-documentation/pulls/1081","id":73983619,"html_url":"https://github.com/edx/edx-documentation/pull/1081","diff_url":"https://github.com/edx/edx-documentation/pull/1081.diff","patch_url":"https://github.com/edx/edx-documentation/pull/1081.patch","issue_url":"https://api.github.com/repos/edx/edx-documentation/issues/1081","number":1081,"state":"open","locked":false,"title":"WIP DOC-3023, DOC-3270: Update SFD and CA doc for discussion UI updates","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":"## [DOC-3023](https://openedx.atlassian.net/browse/DOC-3023)\r\n## [DOC-3270](https://openedx.atlassian.net/browse/DOC-3270)\r\n\r\nUpdates Learners' Guide and Building and Running Course Guide discussion topics to reflect latest state of discussion UI.\r\n\r\nThis PR includes replacing the \"Participating in Course Discussions\" section in the course authors' source with a cross-reference to the nearly identical section in the Learners' Guide. Modifications were made to the Learner's Guide \"Participating in Course Discussions\" to incorporate info from the removed CA source.\r\n\r\n### Date Needed: Aug 23, 2016\r\n\r\n### Reviewers\r\n\r\nPossible roles follow. The PR submitter checks the boxes after each reviewer finishes and gives :+1:. \r\n\r\n- [ ] Subject matter expert: @andy-armstrong \r\n- [ ] Subject matter expert: @bjacobel \r\n- [ ] Doc team review (sanity check/copy edit/dev edit): @pdesjardins or @lamagnifica \r\n- [ ] Product review: @marcotuts \r\n\r\nFYI: \r\n\r\n### HTML Version\r\n\r\n- Course authors: http://draft-ca-discussions.readthedocs.io/en/latest/manage_live_course/discussions.html\r\n\r\n- Learners: http://draft-sfd-discussions.readthedocs.io/en/latest/sfd_discussions/index.html\r\n\r\n### Sandbox (from @bjacobel)\r\n\r\nhttps://discussion-forums-ui-update.sandbox.edx.org/\r\n\r\n### Testing\r\n\r\n- [ ] Ran ./run_tests.sh without warnings or errors\r\n\r\n### Post-review\r\n\r\n- [ ] Add a comment with the description of this change or link this PR to the next release notes task.\r\n- [ ] Squash commits\r\n\r\n\r\n","created_at":"2016-06-15T21:02:58Z","updated_at":"2016-08-19T20:37:31Z","closed_at":null,"merged_at":null,"merge_commit_sha":"92397d878a42388bc9bc1a1586c6ad5c729cf0f2","assignee":null,"assignees":[],"milestone":null,"commits_url":"https://api.github.com/repos/edx/edx-documentation/pulls/1081/commits","review_comments_url":"https://api.github.com/repos/edx/edx-documentation/pulls/1081/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/1081/comments","statuses_url":"https://api.github.com/repos/edx/edx-documentation/statuses/6638390a97ae633e55c937898ea0d48e07b11892","head":{"label":"edx:carol/DOC-disc_forums_UI_update","ref":"carol/DOC-disc_forums_UI_update","sha":"6638390a97ae633e55c937898ea0d48e07b11892","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":"For published versions of the edX documentation, visit:","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}","deployments_url":"https://api.github.com/repos/edx/edx-documentation/deployments","created_at":"2014-09-09T15:29:04Z","updated_at":"2016-08-09T06:42:10Z","pushed_at":"2016-08-19T20:36:10Z","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":" http://docs.edx.org","size":108431,"stargazers_count":46,"watchers_count":46,"language":"Makefile","has_issues":true,"has_downloads":true,"has_wiki":false,"has_pages":true,"forks_count":140,"mirror_url":null,"open_issues_count":25,"forks":140,"open_issues":25,"watchers":46,"default_branch":"master"}},"base":{"label":"edx:master","ref":"master","sha":"66e9ee3f397fb3e400dd43227d1aa2b3de521852","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":"For published versions of the edX documentation, visit:","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}","deployments_url":"https://api.github.com/repos/edx/edx-documentation/deployments","created_at":"2014-09-09T15:29:04Z","updated_at":"2016-08-09T06:42:10Z","pushed_at":"2016-08-19T20:36:10Z","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":" http://docs.edx.org","size":108431,"stargazers_count":46,"watchers_count":46,"language":"Makefile","has_issues":true,"has_downloads":true,"has_wiki":false,"has_pages":true,"forks_count":140,"mirror_url":null,"open_issues_count":25,"forks":140,"open_issues":25,"watchers":46,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/edx/edx-documentation/pulls/1081"},"html":{"href":"https://github.com/edx/edx-documentation/pull/1081"},"issue":{"href":"https://api.github.com/repos/edx/edx-documentation/issues/1081"},"comments":{"href":"https://api.github.com/repos/edx/edx-documentation/issues/1081/comments"},"review_comments":{"href":"https://api.github.com/repos/edx/edx-documentation/pulls/1081/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/1081/commits"},"statuses":{"href":"https://api.github.com/repos/edx/edx-documentation/statuses/6638390a97ae633e55c937898ea0d48e07b11892"}}}}
{"actor":{"display_login":"andy-armstrong"}}