About discussions edits

content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md

@@ -10,70 +10,35 @@ versions:
 
 ## About {% data variables.product.prodname_discussions %}
 
-With {% data variables.product.prodname_discussions %}, the community for your project can create and participate in conversations within the project's repository or organization. Discussions empower a project's maintainers, contributors, and visitors to gather and accomplish the following goals in a central location, without third-party tools.
+{% data variables.product.prodname_discussions %} allows your project's community to engage in conversations about the project's direction and future in an open-ended format. Maintainers, contributors, and visitors can gather in a central location, without third-party tools.
 
-* Share announcements and information, gather feedback, plan, and make decisions
-* Ask questions, discuss and answer the questions, and mark the discussions as answered
-* Create polls to gauge community opinion
-* Upvote discussions and comments to give higher visibility to ideas you find valuable
-* Foster an inviting atmosphere for visitors and contributors to discuss goals, development, administration, and workflows
+* Share announcements and information
+* Plan and make decisions with community input
+* Encourage and answer questions, and mark them answered as you respond to them
+* Gauge community opinion using polls
 
 ![Screenshot of the "Discussions" page for a repository, showing a list of discussions such as "Feedback on the new layout" and "Project direction".](/assets/images/help/discussions/hero.png)
 
-You might use repository discussions to discuss topics that are specific to the repository. If your project spans multiple repositories, you might use organization discussions to discuss topics that aren't specific to a single repository in your organization.
+You can use **repository** discussions to discuss topics that are specific to one repository and **organization** discussions for broader conversations that span multiple repositories.
 
-{% data reusables.discussions.closing-discussions %} For more information, see [Closing a discussion](/discussions/managing-discussions-for-your-community/managing-discussions#closing-a-discussion).
+Anyone with access to a repository or organization can create and participate in discussions there. However, an administrators must enable {% data variables.product.prodname_discussions %} for the repository or organization first.
 
-If a repository administrator or project maintainer enables {% data variables.product.prodname_discussions %} for a repository, anyone who has access to the repository can create and participate in discussions for the repository. If an organization owner enables {% data variables.product.prodname_discussions %} for an organization, anyone who can view the source repository can create an organization discussion.
+## Managing discussions
 
-Repository administrators and project maintainers can manage discussions and discussion categories in a repository, and pin discussions to increase the visibility of the discussion. Moderators and collaborators can mark comments as answers, lock discussions, and convert issues to discussions. Similarly, for organization discussions, the role of a user in the source repository determines how a user can interact with organization discussions. For more information, see [AUTOTITLE](/organizations/managing-user-access-to-your-organizations-repositories/managing-repository-roles/repository-roles-for-an-organization).
+{% data variables.product.prodname_discussions %} includes tools for managing discussions, and for using discussions to manage the repository or organization.
 
-For more information about management of discussions, see [AUTOTITLE](/discussions/managing-discussions-for-your-community/managing-discussions).
+* Pin discussions to give topics more visibility
+* Mark comments as answers in question-and-answer categories to help users find information more quickly
+* Lock discussions that have reached a conclusion or become too heated
+* Convert open-ended issues into discussions
+* Close discussions that are no longer useful
 
-## About polls
-
-You can create polls in the polls category to gauge interest in new ideas and project direction. Anyone with read access to your repository can create polls, vote in polls, and view their results.{% ifversion fpt or ghec %} Signed out users can view the results of polls in public repositories.{% endif %}
-
-Polls require a question and at least two options. You can add a maximum of eight options and the options can contain a maximum of 128 characters.
-
-Voters cannot change their vote. Editing a poll will reset any votes that have already been cast.
-
-For more information on creating polls, see [AUTOTITLE](/discussions/collaborating-with-your-community-using-discussions/participating-in-a-discussion#creating-a-poll).
-
-## About discussion organization
-
-You can organize discussions with categories, sections, and labels.
-
-{% data reusables.discussions.you-can-categorize-discussions %} {% data reusables.discussions.about-categories-and-formats %} {% data reusables.discussions.repository-category-limit %}
-
-For discussions with a question/answer format, an individual comment within the discussion can be marked as the discussion's answer. {% data reusables.discussions.github-recognizes-members %}
-
-{% data reusables.discussions.about-announcement-format %}
-
-{% data reusables.discussions.category-sections %}
-
-For more information, see [AUTOTITLE](/discussions/managing-discussions-for-your-community/managing-categories-for-discussions).
-
-{% data reusables.discussions.you-can-label-discussions %}
-
-## Best practices for {% data variables.product.prodname_discussions %}
-
-As a community member or maintainer, start a discussion to ask a question or discuss information that affects the community. For more information, see [AUTOTITLE](/discussions/collaborating-with-your-community-using-discussions/collaborating-with-maintainers-using-discussions).
-
-Participate in a discussion to ask and answer questions, provide feedback, and engage with the project's community. For more information, see [AUTOTITLE](/discussions/collaborating-with-your-community-using-discussions/participating-in-a-discussion).
-
-You can spotlight discussions that contain important, useful, or exemplary conversations among members in the community. For more information, see [AUTOTITLE](/discussions/managing-discussions-for-your-community/managing-discussions#pinning-a-discussion).
-
-{% data reusables.discussions.you-can-convert-an-issue %} For more information, see [AUTOTITLE](/discussions/managing-discussions-for-your-community/moderating-discussions#converting-an-issue-to-a-discussion).
+Discussions are opened in user-defined categories, and can be further organized with repository labels. For more information about discussion management, see [AUTOTITLE](/discussions/managing-discussions-for-your-community/managing-discussions).
 
 ## Sharing feedback
 
 You can share your feedback about {% data variables.product.prodname_discussions %} with {% data variables.product.company_short %}. To join the conversation, see [{% data variables.product.prodname_github_community %} discussions](https://github.com/orgs/community/discussions/categories/discussions).
 
-## Further reading
+## Next steps
 
-* [AUTOTITLE](/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/about-writing-and-formatting-on-github)
-* [AUTOTITLE](/search-github/searching-on-github/searching-discussions)
-* [AUTOTITLE](/account-and-profile/managing-subscriptions-and-notifications-on-github/setting-up-notifications/about-notifications)
-* [AUTOTITLE](/communities/moderating-comments-and-conversations){% ifversion fpt or ghec %}
-* [AUTOTITLE](/communities/maintaining-your-safety-on-github){% endif %}
+If you're ready to try {% data variables.product.prodname_discussions %}, find out how to get started at [AUTOTITLE](/discussions/quickstart)

content/discussions/collaborating-with-your-community-using-discussions/collaborating-with-maintainers-using-discussions.md

@@ -18,7 +18,7 @@ versions:
 
 Repository administrators and project maintainers can delete a discussion in that repository. Similarly, administrators and maintainers of the source repository for an organization's discussions can delete a discussion in that organization. For more information, see [AUTOTITLE](/discussions/managing-discussions-for-your-community/managing-discussions#deleting-a-discussion).
 
-{% data reusables.discussions.github-recognizes-members %} {%- ifversion fpt %} These members appear in a list of the most helpful contributors to the project's discussions, if their privacy settings allow. For more information, see [AUTOTITLE](/account-and-profile/setting-up-and-managing-your-github-profile/customizing-your-profile/setting-your-profile-to-private).{%- endif %}{%- ifversion ghes or ghec %} These members appear in a list of the most helpful contributors to the project's discussions.{%- endif %}
+{% data variables.product.prodname_dotcom %} will automatically recognize community members who contribute the most comments marked as answers to discussions with a question/answer format. {%- ifversion fpt %} These members appear in a list of the most helpful contributors to the project's discussions, if their privacy settings allow. For more information, see [AUTOTITLE](/account-and-profile/setting-up-and-managing-your-github-profile/customizing-your-profile/setting-your-profile-to-private).{%- endif %}{%- ifversion ghes or ghec %} These members appear in a list of the most helpful contributors to the project's discussions.{%- endif %}
 
 As your project grows, you can grant higher access permissions to active members of your community. For more information, see [AUTOTITLE](/discussions/guides/granting-higher-permissions-to-top-contributors).
 
@@ -91,7 +91,7 @@ You can choose how to sort top-level comments in discussions. Comment threads do
 
 ## Converting an issue to a discussion
 
-{% data reusables.discussions.you-can-convert-an-issue %} For more information, see [AUTOTITLE](/discussions/managing-discussions-for-your-community/moderating-discussions#converting-an-issue-to-a-discussion).
+If an issue turns out to be a question or open-ended conversation instead of a work item to track and prioritize, you can convert the issue to a discussion. For more information, see [AUTOTITLE](/discussions/managing-discussions-for-your-community/moderating-discussions#converting-an-issue-to-a-discussion).
 
 ## Further reading
 

content/discussions/managing-discussions-for-your-community/managing-categories-for-discussions.md

@@ -18,9 +18,9 @@ redirect_from:
 
 {% data reusables.discussions.about-announcement-format %}
 
-Each category must have a unique name and emoji pairing, and can be accompanied by a detailed description stating its purpose. Categories help maintainers organize how conversations are filed and are customizable to help distinguish categories that are Q&A or more open-ended conversations. {% data reusables.discussions.repository-category-limit %} For more information, see [AUTOTITLE](/discussions/collaborating-with-your-community-using-discussions/about-discussions#about-categories-and-formats-for-discussions).
+Each category must have a unique name and emoji pairing, and can be accompanied by a detailed description stating its purpose. Categories help maintainers organize how conversations are filed and are customizable to help distinguish categories that are Q&A or more open-ended conversations. Each repository or organization can have up to 25 categories. For more information, see [AUTOTITLE](/discussions/collaborating-with-your-community-using-discussions/about-discussions#about-categories-and-formats-for-discussions).
 
-{% data reusables.discussions.category-sections %}
+To further organize your discussions, you can create sections and then nest your categories within a section.
 
 ## Default categories
 

content/discussions/managing-discussions-for-your-community/managing-discussions.md

@@ -151,7 +151,7 @@ To transfer a discussion, you must have permissions to create discussions in the
 
 ## Closing a discussion
 
-{% data reusables.discussions.closing-discussions %}
+You can close a discussion when the discussion has been resolved, is no longer relevant, or is a duplicate.
 
 {% data reusables.discussions.navigate-to-repo-or-org %}
 {% data reusables.discussions.discussions-tab %}