diff --git a/content/codespaces/codespaces-reference/disaster-recovery-for-codespaces.md b/content/codespaces/codespaces-reference/disaster-recovery-for-codespaces.md index 2c7575ac08..8c8a895e85 100644 --- a/content/codespaces/codespaces-reference/disaster-recovery-for-codespaces.md +++ b/content/codespaces/codespaces-reference/disaster-recovery-for-codespaces.md @@ -23,7 +23,7 @@ The following guidance provides options on how to handle service disruption to t In this case, no action on your part is required. Know that we are working diligently to restore service availability. -Check our [Discussions page](https://github.com/github/feedback/discussions/categories/codespaces-feedback) for any updates on service interruptions. Soon, you'll be able to see the current service status on the [Status Dashboard](https://www.githubstatus.com/). +Check our [{% data variables.product.prodname_discussions %} page](https://github.com/github/feedback/discussions/categories/codespaces-feedback) for any updates on service interruptions. Soon, you'll be able to see the current service status on the [Status Dashboard](https://www.githubstatus.com/). ## Option 2: Clone the repository locally or edit in the browser 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 4ae83dea39..a7841c397d 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 @@ -7,7 +7,7 @@ versions: {% data reusables.discussions.beta %} -## About discussions +## 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. Discussions empower a project's maintainers, contributors, and visitors to gather and accomplish the following goals in a central location, without third-party tools. @@ -19,7 +19,7 @@ With {% data variables.product.prodname_discussions %}, the community for your p You don't need to close a discussion like you close an issue or a pull request. -If a repository administrator or project maintainer enables discussions for a repository, anyone who visits the repository can create and participate in discussions for the repository. 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. For more information, see "[Repository permission levels for an organization](/organizations/managing-access-to-your-organizations-repositories/repository-permission-levels-for-an-organization)." +If a repository administrator or project maintainer enables {% data variables.product.prodname_discussions %} for a repository, anyone who visits the repository can create and participate in discussions for the repository. 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. For more information, see "[Repository permission levels for an organization](/organizations/managing-access-to-your-organizations-repositories/repository-permission-levels-for-an-organization)." For more information about management of discussions for your repository, see "[Managing discussions in your repository](/discussions/managing-discussions-for-your-community/managing-discussions-in-your-repository)." @@ -37,7 +37,7 @@ For more information, see "[Managing categories for discussions in your reposito {% data reusables.discussions.you-can-label-discussions %} -## Best practices for 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 "[Collaborating with maintainers using discussions](/discussions/collaborating-with-your-community-using-discussions/collaborating-with-maintainers-using-discussions)." 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 67fcb943f6..1bbdba7eb7 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 @@ -9,7 +9,7 @@ versions: {% data reusables.discussions.beta %} -## About collaboration with maintainers using discussions +## About collaboration with maintainers using {% data variables.product.prodname_discussions %} {% data reusables.discussions.about-discussions %} If you use or contribute to a project, you can start a discussion to make suggestions and engage with maintainers and community members about your plans, questions, ideas, and feedback. For more information, see "[‎About discussions](/discussions/collaborating-with-your-community-using-discussions/about-discussions)." @@ -25,7 +25,7 @@ For more information about participation in discussions, see "[Participating in ## Prerequisites -To collaborate with maintainers using discussions, a repository administrator or project maintainer must enable discussions for the repository. For more information, see "[Enabling or disabling discussions for a repository](/github/administering-a-repository/enabling-or-disabling-github-discussions-for-a-repository)." +To collaborate with maintainers in discussions, a repository administrator or project maintainer must enable {% data variables.product.prodname_discussions %} for the repository. For more information, see "[Enabling or disabling {% data variables.product.prodname_discussions %} for a repository](/github/administering-a-repository/enabling-or-disabling-github-discussions-for-a-repository)." ## Starting a discussion diff --git a/content/discussions/collaborating-with-your-community-using-discussions/participating-in-a-discussion.md b/content/discussions/collaborating-with-your-community-using-discussions/participating-in-a-discussion.md index 1d7f6253b2..02a8391b45 100644 --- a/content/discussions/collaborating-with-your-community-using-discussions/participating-in-a-discussion.md +++ b/content/discussions/collaborating-with-your-community-using-discussions/participating-in-a-discussion.md @@ -19,7 +19,7 @@ You can block users and report disruptive content to maintain a safe and pleasan ## Prerequisites -Discussions must be enabled for the repository for you to participate in a discussion in the repository. For more information, see "[Enabling or disabling discussions for a repository](/github/administering-a-repository/enabling-or-disabling-github-discussions-for-a-repository)." +{% data variables.product.prodname_discussions %} must be enabled for the repository for you to participate in a discussion in the repository. For more information, see "[Enabling or disabling {% data variables.product.prodname_discussions %} for a repository](/github/administering-a-repository/enabling-or-disabling-github-discussions-for-a-repository)." ## Creating a discussion diff --git a/content/discussions/guides/best-practices-for-community-conversations-on-github.md b/content/discussions/guides/best-practices-for-community-conversations-on-github.md index dcb01bcc2e..1ef70d9f08 100644 --- a/content/discussions/guides/best-practices-for-community-conversations-on-github.md +++ b/content/discussions/guides/best-practices-for-community-conversations-on-github.md @@ -22,7 +22,7 @@ For more information about opening an issue and cross-referencing a discussion, You can create and participate in discussions, issues, and pull requests, depending on the type of conversation you'd like to have. -You can use {% data variables.product.prodname_discussions %} to discuss big picture ideas, brainstorm, and spike out a project's specific details before committing it to an issue, which can then be scoped. Discussions are useful for teams if: +You can use {% data variables.product.prodname_discussions %} to discuss big picture ideas, brainstorm, and spike out a project's specific details before committing it to an issue, which can then be scoped. {% data variables.product.prodname_discussions %} is useful for teams if: - You are in the discovery phase of a project and are still learning which director your team wants to go in - You want to collect feedback from a wider community about a project - You want to keep bug fixes, feature requests, and general conversations separate diff --git a/content/discussions/guides/granting-higher-permissions-to-top-contributors.md b/content/discussions/guides/granting-higher-permissions-to-top-contributors.md index 8cb5c6da16..370a7b2c3e 100644 --- a/content/discussions/guides/granting-higher-permissions-to-top-contributors.md +++ b/content/discussions/guides/granting-higher-permissions-to-top-contributors.md @@ -12,13 +12,13 @@ shortTitle: Grant higher permissions The most helpful contributors for the past 30 days are highlighted on the {% data variables.product.prodname_discussions %} dashboard, based on how many comments were marked as answers by other community members. Helpful contributors can help drive a healthy community and moderate and guide the community space in addition to maintainers. -## Step 1: Audit your discussions top contributors +## Step 1: Audit your {% data variables.product.prodname_discussions %} top contributors {% data reusables.repositories.navigate-to-repo %} {% data reusables.discussions.discussions-tab %} 1. Compare the list of contributors with their access permissions to see who qualifies to moderate the discussion. -## Step 2: Review permission levels for discussions +## Step 2: Review permission levels for {% data variables.product.prodname_discussions %} People with triage permissions for a repository can help moderate a project's discussions by marking comments as answers, locking discussions that are not longer useful or are damaging to the community, and converting issues to discussions when an idea is still in the early stages of development. For more information, see "[Moderating discussions](/discussions/managing-discussions-for-your-community/moderating-discussions)." diff --git a/content/discussions/managing-discussions-for-your-community/index.md b/content/discussions/managing-discussions-for-your-community/index.md index 868515a2f0..d2ffecd1dd 100644 --- a/content/discussions/managing-discussions-for-your-community/index.md +++ b/content/discussions/managing-discussions-for-your-community/index.md @@ -1,7 +1,7 @@ --- title: Managing discussions for your community shortTitle: Managing discussions -intro: 'You can enable and configure discussions for your repository, and you can use tools on {% data variables.product.product_name %} to moderate conversations among community members.' +intro: 'You can enable and configure {% data variables.product.prodname_discussions %} for your repository, and you can use tools on {% data variables.product.product_name %} to moderate conversations among community members.' versions: fpt: '*' children: diff --git a/content/discussions/managing-discussions-for-your-community/managing-categories-for-discussions-in-your-repository.md b/content/discussions/managing-discussions-for-your-community/managing-categories-for-discussions-in-your-repository.md index 08b164d085..d5a936d7fc 100644 --- a/content/discussions/managing-discussions-for-your-community/managing-categories-for-discussions-in-your-repository.md +++ b/content/discussions/managing-discussions-for-your-community/managing-categories-for-discussions-in-your-repository.md @@ -1,7 +1,7 @@ --- title: Managing categories for discussions in your repository intro: 'You can categorize the discussions in your repository to organize conversations for your community members, and you can choose a format for each category.' -permissions: Repository administrators and people with write or greater access to a repository can enable discussions in the repository. +permissions: Repository administrators and people with write or greater access to a repository can manage categories for discussions in the repository. versions: fpt: '*' shortTitle: Manage categories diff --git a/content/discussions/managing-discussions-for-your-community/managing-discussions-in-your-repository.md b/content/discussions/managing-discussions-for-your-community/managing-discussions-in-your-repository.md index 9c1b7d7009..8c29fb3010 100644 --- a/content/discussions/managing-discussions-for-your-community/managing-discussions-in-your-repository.md +++ b/content/discussions/managing-discussions-for-your-community/managing-discussions-in-your-repository.md @@ -23,7 +23,7 @@ For more information on facilitating a healthy discussion, see "[Moderating comm ## Prerequisites -To manage discussions in a repository, discussions must be enabled for the repository. For more information, see "[Enabling or disabling discussions for a repository](/github/administering-a-repository/enabling-or-disabling-github-discussions-for-a-repository)." +To manage discussions in a repository, {% data variables.product.prodname_discussions %} must be enabled for the repository. For more information, see "[Enabling or disabling {% data variables.product.prodname_discussions %} for a repository](/github/administering-a-repository/enabling-or-disabling-github-discussions-for-a-repository)." ## Changing the category for a discussion diff --git a/content/discussions/managing-discussions-for-your-community/moderating-discussions.md b/content/discussions/managing-discussions-for-your-community/moderating-discussions.md index aed5f06320..fabc5dde25 100644 --- a/content/discussions/managing-discussions-for-your-community/moderating-discussions.md +++ b/content/discussions/managing-discussions-for-your-community/moderating-discussions.md @@ -1,6 +1,6 @@ --- title: Moderating discussions -intro: 'You can promote healthy collaboration by marking comments as answers, locking or unlocking discussions, and converting issues to discussions. and editing or deleting comments, discussions, and categories that don''t align with your community''s code of conduct to discussions.' +intro: 'You can promote healthy collaboration by marking comments as answers, locking or unlocking discussions, converting issues to discussions, and editing or deleting comments, discussions, and categories that don''t align with your community''s code of conduct.' permissions: People with triage access to a repository can moderate discussions in the repository. versions: fpt: '*' diff --git a/content/discussions/quickstart.md b/content/discussions/quickstart.md index a3f26750df..750b7776b1 100644 --- a/content/discussions/quickstart.md +++ b/content/discussions/quickstart.md @@ -19,21 +19,21 @@ Discussions give a space for more collaborative conversations by connecting and Repository owners and people with write access can enable {% data variables.product.prodname_discussions %} for a community on their public and private repositories. -When you first enable a {% data variables.product.prodname_discussions %}, you will be invited to configure a welcome post. +When you first enable {% data variables.product.prodname_discussions %}, you will be invited to configure a welcome post. {% data reusables.repositories.navigate-to-repo %} 1. Under your repository name, click {% octicon "gear" aria-label="The gear icon" %} **Settings**. ![Public settings button](/assets/images/help/discussions/public-repo-settings.png) 1. Under "Features", click **Set up discussions**. - ![Set up a discussion button under "Features" for enabling or disabling discussions for a repository](/assets/images/help/discussions/setup-discussions-button.png) + ![Set up a discussion button under "Features" for enabling or disabling GitHub Discussions for a repository](/assets/images/help/discussions/setup-discussions-button.png) 1. Under "Start a new discussion," edit the template to align with the resources and tone you want to set for your community. 1. Click **Start discussion**. !["Start discussion" button](/assets/images/help/discussions/new-discussion-start-discussion-button.png) ## Welcoming contributions to your discussions -You can welcome your community and introduce a new way to communicate in a repository by creating a welcome post and pin the post to your {% data variables.product.prodname_discussions %} page. Pinning and locking discussions helps people know that a post is meant as an announcement. You can use announcements as a way to link people to more resources and offer guidance for opening discussions in your community. For more information about pinning a discussion, see "[Managing discussions in your repository](/discussions/managing-discussions-for-your-community/managing-discussions-in-your-repository#pinning-a-discussion)." +You can welcome your community and introduce a new way to communicate in a repository by creating a welcome post and pinning the post to your {% data variables.product.prodname_discussions %} page. Pinning and locking discussions helps people know that a post is meant as an announcement. You can use announcements as a way to link people to more resources and offer guidance for opening discussions in your community. For more information about pinning a discussion, see "[Managing discussions in your repository](/discussions/managing-discussions-for-your-community/managing-discussions-in-your-repository#pinning-a-discussion)." ## Setting up community guidelines for contributors diff --git a/content/get-started/using-github/github-for-mobile.md b/content/get-started/using-github/github-for-mobile.md index b7a1089599..00002d37ad 100644 --- a/content/get-started/using-github/github-for-mobile.md +++ b/content/get-started/using-github/github-for-mobile.md @@ -78,7 +78,7 @@ To re-enable Universal Links, long-press any {% data variables.product.product_n If you find a bug in {% data variables.product.prodname_mobile %}, you can email us at mobilefeedback@github.com. -You can submit feature requests or other feedback for {% data variables.product.prodname_mobile %} [on GitHub Discussions](https://github.com/github/feedback/discussions?discussions_q=category%3A%22Mobile+Feedback%22). +You can submit feature requests or other feedback for {% data variables.product.prodname_mobile %} on [{% data variables.product.prodname_discussions %}](https://github.com/github/feedback/discussions?discussions_q=category%3A%22Mobile+Feedback%22). ## Opting out of beta releases for iOS diff --git a/content/github/administering-a-repository/managing-repository-settings/enabling-or-disabling-github-discussions-for-a-repository.md b/content/github/administering-a-repository/managing-repository-settings/enabling-or-disabling-github-discussions-for-a-repository.md index f3846b56b8..9ce25b4795 100644 --- a/content/github/administering-a-repository/managing-repository-settings/enabling-or-disabling-github-discussions-for-a-repository.md +++ b/content/github/administering-a-repository/managing-repository-settings/enabling-or-disabling-github-discussions-for-a-repository.md @@ -1,8 +1,8 @@ --- title: Enabling or disabling GitHub Discussions for a repository -intro: 'You can use discussions in a repository as a place for your community to have conversations, ask questions, and post answers without scoping work in an issue.' +intro: 'You can use {% data variables.product.prodname_discussions %} in a repository as a place for your community to have conversations, ask questions, and post answers without scoping work in an issue.' product: '{% data reusables.gated-features.discussions %}' -permissions: People with admin permissions to a repository can enable discussions for the repository. +permissions: People with admin permissions to a repository can enable {% data variables.product.prodname_discussions %} for the repository. versions: fpt: '*' topics: @@ -13,7 +13,7 @@ shortTitle: Discussions --- {% data reusables.discussions.beta %} -## Enabling or disabling discussions for your repository +## Enabling or disabling {% data variables.product.prodname_discussions %} for your repository {% data reusables.discussions.enabling-or-disabling-github-discussions-for-your-repository %} 1. To disable discussions, under "Features", unselect **Discussions**. diff --git a/content/graphql/guides/using-the-graphql-api-for-discussions.md b/content/graphql/guides/using-the-graphql-api-for-discussions.md index 901e21abb3..e2aa884b79 100644 --- a/content/graphql/guides/using-the-graphql-api-for-discussions.md +++ b/content/graphql/guides/using-the-graphql-api-for-discussions.md @@ -1,6 +1,6 @@ --- title: Using the GraphQL API for Discussions -intro: Learn how to use the GitHub Discussions GraphQL API. +intro: 'Learn how to use the {% data variables.product.prodname_discussions %} GraphQL API.' versions: fpt: '*' shortTitle: Use GraphQL for Discussions diff --git a/content/issues/tracking-your-work-with-issues/about-issues.md b/content/issues/tracking-your-work-with-issues/about-issues.md index 1dab92ef56..dace393faf 100644 --- a/content/issues/tracking-your-work-with-issues/about-issues.md +++ b/content/issues/tracking-your-work-with-issues/about-issues.md @@ -47,7 +47,7 @@ You can @mention collaborators who have access to your repository in an issue to ## Comparing issues and discussions -Some conversations are more suitable for discussions. {% data reusables.discussions.you-can-use-discussions %} For guidance on when to use an issue or a discussion, see "[Communicating on GitHub](/github/getting-started-with-github/quickstart/communicating-on-github)." +Some conversations are more suitable for {% data variables.product.prodname_discussions %}. {% data reusables.discussions.you-can-use-discussions %} For guidance on when to use an issue or a discussion, see "[Communicating on GitHub](/github/getting-started-with-github/quickstart/communicating-on-github)." When a conversation in an issue is better suited for a discussion, you can convert the issue to a discussion. {% endif %} diff --git a/data/reusables/discussions/about-discussions.md b/data/reusables/discussions/about-discussions.md index c61b8b0f0a..846f180578 100644 --- a/data/reusables/discussions/about-discussions.md +++ b/data/reusables/discussions/about-discussions.md @@ -1 +1 @@ -Discussions are an open forum for conversation among maintainers and the community for a project on {% data variables.product.product_name %}. +{% data variables.product.prodname_discussions %} is an open forum for conversation among maintainers and the community for a project on {% data variables.product.product_name %}. diff --git a/data/reusables/discussions/enabling-or-disabling-github-discussions-for-your-repository.md b/data/reusables/discussions/enabling-or-disabling-github-discussions-for-your-repository.md index 2c1343c7f7..aef2c9b7af 100644 --- a/data/reusables/discussions/enabling-or-disabling-github-discussions-for-your-repository.md +++ b/data/reusables/discussions/enabling-or-disabling-github-discussions-for-your-repository.md @@ -1,8 +1,8 @@ -You can enable or disable discussions for a repository. +You can enable or disable {% data variables.product.prodname_discussions %} for a repository. {% data reusables.repositories.navigate-to-repo %} 1. Under your repository name, click {% octicon "gear" aria-label="The gear icon" %} **Settings**. ![Repository settings button](/assets/images/help/discussions/public-repo-settings.png) 1. Under "Features", select **Discussions**. - ![Checkbox under "Features" for enabling or disabling discussions for a repository](/assets/images/help/discussions/select-discussions-checkbox.png) + ![Checkbox under "Features" for enabling or disabling {% data variables.product.prodname_discussions %} for a repository](/assets/images/help/discussions/select-discussions-checkbox.png) diff --git a/data/reusables/discussions/you-can-use-discussions.md b/data/reusables/discussions/you-can-use-discussions.md index 32fc3d682c..db1c058c50 100644 --- a/data/reusables/discussions/you-can-use-discussions.md +++ b/data/reusables/discussions/you-can-use-discussions.md @@ -1 +1 @@ -You can use discussions to ask and answer questions, share information, make announcements, and conduct or participate in conversations about a project. For more information, see "[About discussions](/discussions/collaborating-with-your-community-using-discussions/about-discussions)." +You can use {% data variables.product.prodname_discussions %} to ask and answer questions, share information, make announcements, and conduct or participate in conversations about a project. For more information, see "[About discussions](/discussions/collaborating-with-your-community-using-discussions/about-discussions)."