From b16859730614039134bb8470faa0d2f5ff2a0003 Mon Sep 17 00:00:00 2001 From: Sharra-writes Date: Mon, 9 Jun 2025 20:17:09 -0700 Subject: [PATCH 01/23] Update about-discussions.md for scanability --- .../about-discussions.md | 17 +++++++++-------- 1 file changed, 9 insertions(+), 8 deletions(-) diff --git a/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md b/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md index 0befc83d91d8..5f6fb2d3a028 100644 --- a/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md +++ b/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md @@ -12,27 +12,28 @@ versions: 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. -* 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 +* Share announcements and information +* Plan and make decisions with community input +* Encourage and answer questions, and mark them answered as you respond to them +* Gather feedback using 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 ![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 might use repository discussions to discuss topics that are specific to the repository. If your project spans multiple repositories, {% data variables.product.prodname_discussions %} can also be used for broader conversations that affect the entire organization. {% data reusables.discussions.closing-discussions %} For more information, see [Closing a discussion](/discussions/managing-discussions-for-your-community/managing-discussions#closing-a-discussion). -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. +Anyone who can has access to a repository can create and participate in discussions once a repository administrator or project maintainer has enabled {% data variables.product.prodname_discussions %}. Similarly, 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. -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). +Repository administrators and project maintainers can manage discussions and discussion categories in a repository, and pin discussions to increase the visibility of a topic. Moderators and collaborators can mark comments as answers, lock discussions, and convert issues to discussions. 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). For more information about management of discussions, see [AUTOTITLE](/discussions/managing-discussions-for-your-community/managing-discussions). ## 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 %} +If you're looking to gauge interest in new ideas or project direction, you can create polls in the polls category of {% data variables.product.prodname_discussions %}. Anyone with read access to your repository can create polls, vote in polls, and view poll 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. @@ -42,7 +43,7 @@ For more information on creating polls, see [AUTOTITLE](/discussions/collaborati ## About discussion organization -You can organize discussions with categories, sections, and labels. +Discussions can be organized 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 %} From f7f8ede2eab07f01eb06736e71d3c8696901054f Mon Sep 17 00:00:00 2001 From: Sharra-writes Date: Mon, 9 Jun 2025 20:57:54 -0700 Subject: [PATCH 02/23] Small edits --- .../about-discussions.md | 4 +--- data/reusables/discussions/you-can-categorize-discussions.md | 2 +- 2 files changed, 2 insertions(+), 4 deletions(-) diff --git a/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md b/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md index 5f6fb2d3a028..15752429e336 100644 --- a/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md +++ b/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md @@ -51,9 +51,7 @@ For discussions with a question/answer format, an individual comment within the {% 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.category-sections %} For more information, see [AUTOTITLE](/discussions/managing-discussions-for-your-community/managing-categories-for-discussions). {% data reusables.discussions.you-can-label-discussions %} diff --git a/data/reusables/discussions/you-can-categorize-discussions.md b/data/reusables/discussions/you-can-categorize-discussions.md index bb05316d772c..5035bfee8921 100644 --- a/data/reusables/discussions/you-can-categorize-discussions.md +++ b/data/reusables/discussions/you-can-categorize-discussions.md @@ -1 +1 @@ -You can categorize discussions to help community members begin conversations in the right place, and to help community members find related discussions. +You can categorize discussions to help community members begin conversations in the right place, and to help them find related discussions. From 68284474b34946c7ab69b7b8d57fa2fddea17871 Mon Sep 17 00:00:00 2001 From: Sharra-writes Date: Thu, 12 Jun 2025 11:16:03 -0700 Subject: [PATCH 03/23] Get rid of unused reusable. --- data/reusables/discussions/you-can-categorize-discussions.md | 1 - 1 file changed, 1 deletion(-) delete mode 100644 data/reusables/discussions/you-can-categorize-discussions.md diff --git a/data/reusables/discussions/you-can-categorize-discussions.md b/data/reusables/discussions/you-can-categorize-discussions.md deleted file mode 100644 index 5035bfee8921..000000000000 --- a/data/reusables/discussions/you-can-categorize-discussions.md +++ /dev/null @@ -1 +0,0 @@ -You can categorize discussions to help community members begin conversations in the right place, and to help them find related discussions. From 33f29ea47a799b1a225537b28b2fe2d0c57f4aa9 Mon Sep 17 00:00:00 2001 From: Sharra-writes Date: Thu, 12 Jun 2025 12:49:45 -0700 Subject: [PATCH 04/23] Reorganized the article --- .../about-discussions.md | 32 +++---------------- 1 file changed, 5 insertions(+), 27 deletions(-) diff --git a/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md b/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md index 15752429e336..c9fc49646c08 100644 --- a/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md +++ b/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md @@ -23,39 +23,17 @@ With {% data variables.product.prodname_discussions %}, the community for your p You might use repository discussions to discuss topics that are specific to the repository. If your project spans multiple repositories, {% data variables.product.prodname_discussions %} can also be used for broader conversations that affect the entire organization. -{% data reusables.discussions.closing-discussions %} For more information, see [Closing a discussion](/discussions/managing-discussions-for-your-community/managing-discussions#closing-a-discussion). +Anyone who can has access to a repository can create and participate in discussions once a repository administrator or project maintainer has enabled {% data variables.product.prodname_discussions %}. Similarly, 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. -Anyone who can has access to a repository can create and participate in discussions once a repository administrator or project maintainer has enabled {% data variables.product.prodname_discussions %}. Similarly, 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. - -Repository administrators and project maintainers can manage discussions and discussion categories in a repository, and pin discussions to increase the visibility of a topic. Moderators and collaborators can mark comments as answers, lock discussions, and convert issues to discussions. 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). - -For more information about management of discussions, see [AUTOTITLE](/discussions/managing-discussions-for-your-community/managing-discussions). - -## About polls - -If you're looking to gauge interest in new ideas or project direction, you can create polls in the polls category of {% data variables.product.prodname_discussions %}. Anyone with read access to your repository can create polls, vote in polls, and view poll 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. +{% data variables.product.prodname_discussions %} offers you varying levels of granularity for organizing discussions. Discussions are opened in categories defined by anyone with maintain or admin permissions. Categories come with different formats, such as announcements, question and answer, polls, or open-ended, and categories can be further organized under sections you specify. Individual discussions can be categorized with more specificity by applying labels. For more information about managing categories, see [AUTOTITLE](/discussions/managing-discussions-for-your-community/managing-categories-for-discussions). 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 +Repository administrators and project maintainers can manage discussions and discussion categories in a repository. Discussions can be pinned to give topics more visibility. Moderators and collaborators can mark comments as answers, lock discussions, and convert issues to discussions. For organization discussions, the role of a user in the source repository determines how a user can interact with organization discussions. For more information about organization repository roles, see [AUTOTITLE](/organizations/managing-user-access-to-your-organizations-repositories/managing-repository-roles/repository-roles-for-an-organization). -Discussions can be organized 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 %} +For more information about management of discussions, see [AUTOTITLE](/discussions/managing-discussions-for-your-community/managing-discussions). -## Best practices for {% data variables.product.prodname_discussions %} +## Use cases 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). From 8ba780473c7531f8f963690cbb9c9feedc92fe8a Mon Sep 17 00:00:00 2001 From: Sharra-writes Date: Thu, 12 Jun 2025 19:48:17 -0700 Subject: [PATCH 05/23] Update content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md --- .../about-discussions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md b/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md index c9fc49646c08..a188f5cfa3a6 100644 --- a/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md +++ b/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md @@ -12,7 +12,7 @@ versions: 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. -* Share announcements and information +* Share announcements and information * Plan and make decisions with community input * Encourage and answer questions, and mark them answered as you respond to them * Gather feedback using polls to gauge community opinion From 3b6bd2e702cab0e1f7009b8f769239cf805aca4c Mon Sep 17 00:00:00 2001 From: Sharra-writes Date: Fri, 13 Jun 2025 11:06:11 -0700 Subject: [PATCH 06/23] All the bullet points --- .../about-discussions.md | 23 ++++++++++++++++--- 1 file changed, 20 insertions(+), 3 deletions(-) diff --git a/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md b/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md index a188f5cfa3a6..d443c8f1fcb7 100644 --- a/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md +++ b/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md @@ -23,13 +23,30 @@ With {% data variables.product.prodname_discussions %}, the community for your p You might use repository discussions to discuss topics that are specific to the repository. If your project spans multiple repositories, {% data variables.product.prodname_discussions %} can also be used for broader conversations that affect the entire organization. -Anyone who can has access to a repository can create and participate in discussions once a repository administrator or project maintainer has enabled {% data variables.product.prodname_discussions %}. Similarly, 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. +Anyone who can has access to a repository can create and participate in discussions once a repository administrator or project maintainer has enabled {% data variables.product.prodname_discussions %}. Similarly, 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. -{% data variables.product.prodname_discussions %} offers you varying levels of granularity for organizing discussions. Discussions are opened in categories defined by anyone with maintain or admin permissions. Categories come with different formats, such as announcements, question and answer, polls, or open-ended, and categories can be further organized under sections you specify. Individual discussions can be categorized with more specificity by applying labels. For more information about managing categories, see [AUTOTITLE](/discussions/managing-discussions-for-your-community/managing-categories-for-discussions). +## Organizing discussions + +{% data variables.product.prodname_discussions %} offers you varying levels of granularity for organizing discussions: + +* Discussions are opened in categories defined by anyone with maintain or admin permissions +* Categories come with different formats, such as announcements, question-and-answer, polls, or open-ended +* Categories can be further organized under sections you specify +* Individual discussions can be categorized with more specificity by applying labels. + +For more information about managing categories, see [AUTOTITLE](/discussions/managing-discussions-for-your-community/managing-categories-for-discussions). For more information on creating polls, see [AUTOTITLE](/discussions/collaborating-with-your-community-using-discussions/participating-in-a-discussion#creating-a-poll). -Repository administrators and project maintainers can manage discussions and discussion categories in a repository. Discussions can be pinned to give topics more visibility. Moderators and collaborators can mark comments as answers, lock discussions, and convert issues to discussions. For organization discussions, the role of a user in the source repository determines how a user can interact with organization discussions. For more information about organization repository roles, see [AUTOTITLE](/organizations/managing-user-access-to-your-organizations-repositories/managing-repository-roles/repository-roles-for-an-organization). +## Managing discussions + +In addition to sorting discussions by category, section, and label, {% data variables.product.prodname_discussions %} includes other tools for managing discussions. + +* Discussions can be pinned to give topics more visibility +* Comments can be marked as answers in question-and-answer categories to help readers find the most useful response quickly +* If a discussion has run its course or gotten too heated, it can be locked +* Issues that turn out to be too open-ended can be converted to a discussion +* Moderators can close discussions that are no longer useful For more information about management of discussions, see [AUTOTITLE](/discussions/managing-discussions-for-your-community/managing-discussions). From 69f2d52370a49502f0a285052f2c794aa5466bfd Mon Sep 17 00:00:00 2001 From: Sharra-writes Date: Fri, 13 Jun 2025 11:12:21 -0700 Subject: [PATCH 07/23] Words, what are they? --- .../about-discussions.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md b/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md index d443c8f1fcb7..9ac187eedacc 100644 --- a/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md +++ b/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md @@ -31,7 +31,7 @@ Anyone who can has access to a repository can create and participate in discussi * Discussions are opened in categories defined by anyone with maintain or admin permissions * Categories come with different formats, such as announcements, question-and-answer, polls, or open-ended -* Categories can be further organized under sections you specify +* Categories can be further organized under sections you create * Individual discussions can be categorized with more specificity by applying labels. For more information about managing categories, see [AUTOTITLE](/discussions/managing-discussions-for-your-community/managing-categories-for-discussions). @@ -44,7 +44,7 @@ In addition to sorting discussions by category, section, and label, {% data vari * Discussions can be pinned to give topics more visibility * Comments can be marked as answers in question-and-answer categories to help readers find the most useful response quickly -* If a discussion has run its course or gotten too heated, it can be locked +* If a discussion has reached a conclusion or gotten too heated, it can be locked * Issues that turn out to be too open-ended can be converted to a discussion * Moderators can close discussions that are no longer useful From 20dc7439fc87e05131f6d842e1c18dc78c5e9602 Mon Sep 17 00:00:00 2001 From: Sharra-writes Date: Fri, 13 Jun 2025 11:33:55 -0700 Subject: [PATCH 08/23] Update content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md --- .../about-discussions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md b/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md index 9ac187eedacc..31ec12a53ba9 100644 --- a/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md +++ b/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md @@ -32,7 +32,7 @@ Anyone who can has access to a repository can create and participate in discussi * Discussions are opened in categories defined by anyone with maintain or admin permissions * Categories come with different formats, such as announcements, question-and-answer, polls, or open-ended * Categories can be further organized under sections you create -* Individual discussions can be categorized with more specificity by applying labels. +* Individual discussions can be categorized with more specificity by applying labels For more information about managing categories, see [AUTOTITLE](/discussions/managing-discussions-for-your-community/managing-categories-for-discussions). From 247abb75df41217b68860c82add9f245e917b88f Mon Sep 17 00:00:00 2001 From: Sharra-writes Date: Fri, 13 Jun 2025 12:57:57 -0700 Subject: [PATCH 09/23] Trimming more fat, paring down links --- .../about-discussions.md | 16 +++------------- 1 file changed, 3 insertions(+), 13 deletions(-) diff --git a/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md b/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md index 9ac187eedacc..2cb469717609 100644 --- a/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md +++ b/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md @@ -40,26 +40,16 @@ For more information on creating polls, see [AUTOTITLE](/discussions/collaborati ## Managing discussions -In addition to sorting discussions by category, section, and label, {% data variables.product.prodname_discussions %} includes other tools for managing discussions. +In addition to sorting discussions by category, section, and label, {% data variables.product.prodname_discussions %} includes other tools for managing discussions, and using discussions to manage the repository or organization. -* Discussions can be pinned to give topics more visibility +* Discussions can be pinned to give topics more visibility, see [AUTOTITLE](/discussions/managing-discussions-for-your-community/managing-discussions#pinning-a-discussion) * Comments can be marked as answers in question-and-answer categories to help readers find the most useful response quickly * If a discussion has reached a conclusion or gotten too heated, it can be locked -* Issues that turn out to be too open-ended can be converted to a discussion +* Issues that turn out to be too open-ended can be converted to a discussion, see [AUTOTITLE](/discussions/managing-discussions-for-your-community/moderating-discussions#converting-an-issue-to-a-discussion) * Moderators can close discussions that are no longer useful For more information about management of discussions, see [AUTOTITLE](/discussions/managing-discussions-for-your-community/managing-discussions). -## Use cases 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). - ## 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). From ca60c4bcf6557ff7335fcf872637a96ba40456f0 Mon Sep 17 00:00:00 2001 From: Sharra-writes Date: Fri, 13 Jun 2025 13:45:04 -0700 Subject: [PATCH 10/23] Trimmed more links --- .../about-discussions.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md b/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md index e39ebfbbabb6..e97d3b2ad1e8 100644 --- a/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md +++ b/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md @@ -42,13 +42,13 @@ For more information on creating polls, see [AUTOTITLE](/discussions/collaborati In addition to sorting discussions by category, section, and label, {% data variables.product.prodname_discussions %} includes other tools for managing discussions, and using discussions to manage the repository or organization. -* Discussions can be pinned to give topics more visibility, see [AUTOTITLE](/discussions/managing-discussions-for-your-community/managing-discussions#pinning-a-discussion) +* Discussions can be pinned to give topics more visibility * Comments can be marked as answers in question-and-answer categories to help readers find the most useful response quickly * If a discussion has reached a conclusion or gotten too heated, it can be locked -* Issues that turn out to be too open-ended can be converted to a discussion, see [AUTOTITLE](/discussions/managing-discussions-for-your-community/moderating-discussions#converting-an-issue-to-a-discussion) +* Issues that turn out to be too open-ended can be converted to a discussion * Moderators can close discussions that are no longer useful -For more information about management of discussions, see [AUTOTITLE](/discussions/managing-discussions-for-your-community/managing-discussions). +For more information about discussion management, see [AUTOTITLE](/discussions/managing-discussions-for-your-community/managing-discussions). ## Sharing feedback From 35aa2053bcf352e717eff3c75ebcda8891b2e116 Mon Sep 17 00:00:00 2001 From: Sharra-writes Date: Fri, 13 Jun 2025 15:24:21 -0700 Subject: [PATCH 11/23] Paring down unneeded reusables --- .../managing-discussions.md | 2 +- data/reusables/discussions/closing-discussions.md | 1 - 2 files changed, 1 insertion(+), 2 deletions(-) delete mode 100644 data/reusables/discussions/closing-discussions.md diff --git a/content/discussions/managing-discussions-for-your-community/managing-discussions.md b/content/discussions/managing-discussions-for-your-community/managing-discussions.md index 3854061b0258..6771110456b5 100644 --- a/content/discussions/managing-discussions-for-your-community/managing-discussions.md +++ b/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 %} diff --git a/data/reusables/discussions/closing-discussions.md b/data/reusables/discussions/closing-discussions.md deleted file mode 100644 index 13d5ba6e5290..000000000000 --- a/data/reusables/discussions/closing-discussions.md +++ /dev/null @@ -1 +0,0 @@ -You can close a discussion when the discussion has been resolved, is no longer relevant, or is a duplicate. From 2fb11cafaf77bf9fef02868c076fdd7076251fe5 Mon Sep 17 00:00:00 2001 From: Sharra-writes Date: Mon, 16 Jun 2025 10:54:04 -0700 Subject: [PATCH 12/23] Update content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md Co-authored-by: Laura Coursen --- .../about-discussions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md b/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md index e97d3b2ad1e8..f9d5c9ead704 100644 --- a/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md +++ b/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md @@ -10,7 +10,7 @@ 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. +With {% data variables.product.prodname_discussions %}, the community for your project can create and participate in conversations within a repository or organization. Maintainers, contributors, and visitors can gather in a central location, without third-party tools. * Share announcements and information * Plan and make decisions with community input From 31b7577800392834cf30c2636266d9550b8ac830 Mon Sep 17 00:00:00 2001 From: Sharra-writes Date: Mon, 16 Jun 2025 11:13:18 -0700 Subject: [PATCH 13/23] Update content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md Co-authored-by: Laura Coursen --- .../about-discussions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md b/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md index f9d5c9ead704..3371c3b3f30c 100644 --- a/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md +++ b/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md @@ -21,7 +21,7 @@ With {% data variables.product.prodname_discussions %}, the community for your p ![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, {% data variables.product.prodname_discussions %} can also be used for broader conversations that affect the entire organization. +You can use **repository** discussions to discuss topics that are specific to one repository and **organization** discussions for broader conversations that spans multiple repositories. Anyone who can has access to a repository can create and participate in discussions once a repository administrator or project maintainer has enabled {% data variables.product.prodname_discussions %}. Similarly, 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. From 6afd86d70acb10cebf613ef6a786b5b56b4f6355 Mon Sep 17 00:00:00 2001 From: Sharra-writes Date: Mon, 16 Jun 2025 11:13:34 -0700 Subject: [PATCH 14/23] Update content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md Co-authored-by: Laura Coursen --- .../about-discussions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md b/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md index 3371c3b3f30c..9f6b69f52e9b 100644 --- a/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md +++ b/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md @@ -15,7 +15,7 @@ With {% data variables.product.prodname_discussions %}, the community for your p * Share announcements and information * Plan and make decisions with community input * Encourage and answer questions, and mark them answered as you respond to them -* Gather feedback using polls to gauge community opinion +* Gauge community opinion using polls * 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 From 30cb5450dffe5cca046682b2e9ec52180a4ca79f Mon Sep 17 00:00:00 2001 From: Sharra-writes Date: Tue, 17 Jun 2025 11:09:12 -0700 Subject: [PATCH 15/23] Update content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md --- .../about-discussions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md b/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md index 9f6b69f52e9b..68e65f79340a 100644 --- a/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md +++ b/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md @@ -15,7 +15,7 @@ With {% data variables.product.prodname_discussions %}, the community for your p * 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 +* Gauge community opinion using polls * 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 From b0ac6fa0dae102b81f8fea32fc53218109d00b4c Mon Sep 17 00:00:00 2001 From: Sharra-writes Date: Tue, 17 Jun 2025 11:12:15 -0700 Subject: [PATCH 16/23] Next steps instead of further reading --- .../about-discussions.md | 8 ++------ 1 file changed, 2 insertions(+), 6 deletions(-) diff --git a/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md b/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md index 68e65f79340a..b90512379cd3 100644 --- a/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md +++ b/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md @@ -54,10 +54,6 @@ For more information about discussion management, see [AUTOTITLE](/discussions/m 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 %} From 244694b366fb597ae9703ec77609514fe74949b9 Mon Sep 17 00:00:00 2001 From: Sharra-writes Date: Wed, 18 Jun 2025 09:31:20 -0700 Subject: [PATCH 17/23] Refined subheadings --- .../about-discussions.md | 31 ++++++------------- 1 file changed, 10 insertions(+), 21 deletions(-) diff --git a/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md b/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md index b90512379cd3..52eceebc0ecd 100644 --- a/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md +++ b/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md @@ -21,32 +21,21 @@ With {% data variables.product.prodname_discussions %}, the community for your p ![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 can use **repository** discussions to discuss topics that are specific to one repository and **organization** discussions for broader conversations that spans multiple repositories. +You can use **repository** discussions to discuss topics that are specific to one repository and **organization** discussions for broader conversations that span multiple repositories. Anyone who can has access to a repository can create and participate in discussions once a repository administrator or project maintainer has enabled {% data variables.product.prodname_discussions %}. Similarly, 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. -## Organizing discussions - -{% data variables.product.prodname_discussions %} offers you varying levels of granularity for organizing discussions: - -* Discussions are opened in categories defined by anyone with maintain or admin permissions -* Categories come with different formats, such as announcements, question-and-answer, polls, or open-ended -* Categories can be further organized under sections you create -* Individual discussions can be categorized with more specificity by applying labels - -For more information about managing categories, see [AUTOTITLE](/discussions/managing-discussions-for-your-community/managing-categories-for-discussions). - -For more information on creating polls, see [AUTOTITLE](/discussions/collaborating-with-your-community-using-discussions/participating-in-a-discussion#creating-a-poll). - ## Managing discussions -In addition to sorting discussions by category, section, and label, {% data variables.product.prodname_discussions %} includes other tools for managing discussions, and using discussions to manage the repository or organization. +Discussions are created in user-defined categories and can be further organized with labels. + +In addition to sorting discussions, {% data variables.product.prodname_discussions %} includes other tools for managing discussions, and using discussions to manage the repository or organization. -* Discussions can be pinned to give topics more visibility -* Comments can be marked as answers in question-and-answer categories to help readers find the most useful response quickly -* If a discussion has reached a conclusion or gotten too heated, it can be locked -* Issues that turn out to be too open-ended can be converted to a discussion -* Moderators can close discussions that are no longer useful +* Discussions can be pinned to give topics more visibility. +* Comments can be marked as answers in question-and-answer categories to help readers find the most useful response quickly. +* If a discussion has reached a conclusion or gotten too heated, it can be locked. +* Issues that turn out to be too open-ended can be converted to a discussion. +* Moderators can close discussions that are no longer useful. For more information about discussion management, see [AUTOTITLE](/discussions/managing-discussions-for-your-community/managing-discussions). @@ -56,4 +45,4 @@ You can share your feedback about {% data variables.product.prodname_discussions ## Next steps - +Ready to try {% data variables.product.prodname_discussions %}? Find out how to get started at [AUTOTITLE](/discussions/quickstart) From dee03a06cd05e21617a7031c0ed154ab19f7c511 Mon Sep 17 00:00:00 2001 From: Sharra-writes Date: Wed, 18 Jun 2025 10:29:10 -0700 Subject: [PATCH 18/23] intro reworking --- .../about-discussions.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md b/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md index 52eceebc0ecd..7ff775651a70 100644 --- a/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md +++ b/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md @@ -10,7 +10,7 @@ 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 a repository or organization. Maintainers, contributors, and visitors can gather 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 * Plan and make decisions with community input @@ -29,7 +29,7 @@ Anyone who can has access to a repository can create and participate in discussi Discussions are created in user-defined categories and can be further organized with labels. -In addition to sorting discussions, {% data variables.product.prodname_discussions %} includes other tools for managing discussions, and using discussions to manage the repository or organization. +In addition to organzing discussions, {% data variables.product.prodname_discussions %} includes other tools for managing discussions, and using discussions to manage the repository or organization. * Discussions can be pinned to give topics more visibility. * Comments can be marked as answers in question-and-answer categories to help readers find the most useful response quickly. From d86996bd48d717cb745a9f11114f74cece57ad54 Mon Sep 17 00:00:00 2001 From: Sharra-writes Date: Wed, 18 Jun 2025 10:30:50 -0700 Subject: [PATCH 19/23] Update content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md Co-authored-by: Laura Coursen --- .../about-discussions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md b/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md index 7ff775651a70..505eac3532ef 100644 --- a/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md +++ b/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md @@ -23,7 +23,7 @@ versions: You can use **repository** discussions to discuss topics that are specific to one repository and **organization** discussions for broader conversations that span multiple repositories. -Anyone who can has access to a repository can create and participate in discussions once a repository administrator or project maintainer has enabled {% data variables.product.prodname_discussions %}. Similarly, 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. +Anyone who can access 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. ## Managing discussions From 34da44a257c4b824532a6eeb8654b5b04e451559 Mon Sep 17 00:00:00 2001 From: Sharra-writes Date: Wed, 18 Jun 2025 11:13:25 -0700 Subject: [PATCH 20/23] Wording updates --- .../about-discussions.md | 22 ++++++++----------- 1 file changed, 9 insertions(+), 13 deletions(-) diff --git a/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md b/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md index 505eac3532ef..9a3a8e94dca0 100644 --- a/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md +++ b/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md @@ -16,28 +16,24 @@ versions: * 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 -* 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 ![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 can use **repository** discussions to discuss topics that are specific to one repository and **organization** discussions for broader conversations that span multiple repositories. -Anyone who can access 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. +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. ## Managing discussions -Discussions are created in user-defined categories and can be further organized with labels. +{% data variables.product.prodname_discussions %} includes tools for managing discussions, and for using discussions to manage the repository or organization. -In addition to organzing discussions, {% data variables.product.prodname_discussions %} includes other tools for managing discussions, and using discussions to manage the repository or organization. +* 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 -* Discussions can be pinned to give topics more visibility. -* Comments can be marked as answers in question-and-answer categories to help readers find the most useful response quickly. -* If a discussion has reached a conclusion or gotten too heated, it can be locked. -* Issues that turn out to be too open-ended can be converted to a discussion. -* Moderators can close discussions that are no longer useful. - -For more information about discussion management, see [AUTOTITLE](/discussions/managing-discussions-for-your-community/managing-discussions). +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 @@ -45,4 +41,4 @@ You can share your feedback about {% data variables.product.prodname_discussions ## Next steps -Ready to try {% data variables.product.prodname_discussions %}? Find out how to get started at [AUTOTITLE](/discussions/quickstart) +If you're ready to try {% data variables.product.prodname_discussions %}, find out how to get started at [AUTOTITLE](/discussions/quickstart) From d5bce9c30031fc27db55cb33f4a9b73e3db2a871 Mon Sep 17 00:00:00 2001 From: Sharra-writes Date: Wed, 18 Jun 2025 14:52:13 -0700 Subject: [PATCH 21/23] cleanup on aisle reusable --- .../collaborating-with-maintainers-using-discussions.md | 4 ++-- .../managing-categories-for-discussions.md | 4 ++-- data/reusables/discussions/category-sections.md | 1 - data/reusables/discussions/github-recognizes-members.md | 1 - data/reusables/discussions/repository-category-limit.md | 1 - data/reusables/discussions/you-can-convert-an-issue.md | 1 - 6 files changed, 4 insertions(+), 8 deletions(-) delete mode 100644 data/reusables/discussions/category-sections.md delete mode 100644 data/reusables/discussions/github-recognizes-members.md delete mode 100644 data/reusables/discussions/repository-category-limit.md delete mode 100644 data/reusables/discussions/you-can-convert-an-issue.md diff --git a/content/discussions/collaborating-with-your-community-using-discussions/collaborating-with-maintainers-using-discussions.md b/content/discussions/collaborating-with-your-community-using-discussions/collaborating-with-maintainers-using-discussions.md index 8c3a5e54cfd0..2fa684839532 100644 --- a/content/discussions/collaborating-with-your-community-using-discussions/collaborating-with-maintainers-using-discussions.md +++ b/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 diff --git a/content/discussions/managing-discussions-for-your-community/managing-categories-for-discussions.md b/content/discussions/managing-discussions-for-your-community/managing-categories-for-discussions.md index 912689cd3978..b07da2f85f74 100644 --- a/content/discussions/managing-discussions-for-your-community/managing-categories-for-discussions.md +++ b/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 diff --git a/data/reusables/discussions/category-sections.md b/data/reusables/discussions/category-sections.md deleted file mode 100644 index 01aeaa797e1e..000000000000 --- a/data/reusables/discussions/category-sections.md +++ /dev/null @@ -1 +0,0 @@ -To further organize your discussions, you can create sections and then nest your categories within a section. diff --git a/data/reusables/discussions/github-recognizes-members.md b/data/reusables/discussions/github-recognizes-members.md deleted file mode 100644 index b6874b910d34..000000000000 --- a/data/reusables/discussions/github-recognizes-members.md +++ /dev/null @@ -1 +0,0 @@ -{% 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. diff --git a/data/reusables/discussions/repository-category-limit.md b/data/reusables/discussions/repository-category-limit.md deleted file mode 100644 index 1d54add1fee1..000000000000 --- a/data/reusables/discussions/repository-category-limit.md +++ /dev/null @@ -1 +0,0 @@ -Each repository or organization can have up to 25 categories. diff --git a/data/reusables/discussions/you-can-convert-an-issue.md b/data/reusables/discussions/you-can-convert-an-issue.md deleted file mode 100644 index 1421256e1f64..000000000000 --- a/data/reusables/discussions/you-can-convert-an-issue.md +++ /dev/null @@ -1 +0,0 @@ -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. From 75c29f5a89b1acccf0d1b33e298f68f58744efa0 Mon Sep 17 00:00:00 2001 From: Sharra-writes Date: Wed, 25 Jun 2025 12:30:06 -0700 Subject: [PATCH 22/23] Update content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md Co-authored-by: Sam Browning <106113886+sabrowning1@users.noreply.github.com> --- .../about-discussions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md b/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md index 9a3a8e94dca0..d4cc7b8df399 100644 --- a/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md +++ b/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md @@ -21,7 +21,7 @@ versions: You can use **repository** discussions to discuss topics that are specific to one repository and **organization** discussions for broader conversations that span multiple repositories. -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. +Anyone with access to a repository or organization can create and participate in discussions there. However, an administrator must enable {% data variables.product.prodname_discussions %} for the repository or organization first. ## Managing discussions From 8e167f87cb1da858a29467767cb326790041304a Mon Sep 17 00:00:00 2001 From: Sharra-writes Date: Wed, 25 Jun 2025 12:30:23 -0700 Subject: [PATCH 23/23] Update content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md Co-authored-by: Sam Browning <106113886+sabrowning1@users.noreply.github.com> --- .../about-discussions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md b/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md index d4cc7b8df399..3b1db0f8173d 100644 --- a/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md +++ b/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md @@ -41,4 +41,4 @@ You can share your feedback about {% data variables.product.prodname_discussions ## Next steps -If you're ready to try {% data variables.product.prodname_discussions %}, find out how to get started at [AUTOTITLE](/discussions/quickstart) +If you're ready to try {% data variables.product.prodname_discussions %}, get started at [AUTOTITLE](/discussions/quickstart).