зеркало из https://github.com/github/docs.git
Use GitHub Discussions product name (#20366)
This commit is contained in:
Laura Coursen
GitHub
Родитель
690914e815
Коммит
2d9de946b5
|
|
@ -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
|
||||
|
||||
|
|
|
|||
|
|
@ -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)."
|
||||
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
|
|
|||
|
|
@ -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)."
|
||||
|
||||
|
|
|
|||
|
|
@ -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:
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
||||
|
|
|
|||
|
|
@ -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: '*'
|
||||
|
|
|
|||
|
|
@ -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**.
|
||||
|
||||
1. Under "Features", click **Set up discussions**.
|
||||
|
||||
|
||||
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**.
|
||||
|
||||
|
||||
## 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
|
||||
|
|
|
|||
|
|
@ -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 <a href="mailto:mobilefeedback@github.com">mobilefeedback@github.com</a>.
|
||||
|
||||
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
|
||||
|
||||
|
|
|
|||
|
|
@ -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**.
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
|
|
|||
|
|
@ -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 %}
|
||||
|
|
|
|||
|
|
@ -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 %}.
|
||||
|
|
|
|||
|
|
@ -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**.
|
||||
|
||||
1. Under "Features", select **Discussions**.
|
||||
|
||||
|
||||
|
|
|
|||
|
|
@ -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)."
|
||||
|
|
|
|||
Загрузка…
Ссылка в новой задаче