Skip to main content

Managing discussions

You can categorize, spotlight, transfer, or delete the discussions.

Who can use this feature

Repository administrators and people with write or greater access to a repository can manage discussions in the repository. Repository administrators and people with write or greater access to the source repository for organization discussions can manage discussions in the organization.

About management of discussions

Los GitHub Discussions son un foro abierto para tener conversaciones entre los mantenedores y la comunidad para un repositorio u organización en GitHub. For more information about discussions, see "About discussions."

Organization owners can choose the permissions required to create a discussion in repositories owned by the organization. Similarly, to choose the permissions required to create an organization discussion, organization owners can change the permissions required in the source repository. For more information, see "Managing discussion creation for repositories in your organization."

As a discussions maintainer, you can create community resources to encourage discussions that are aligned with the overall project goal and maintain a friendly open forum for collaborators. Creating a code of conduct or contribution guidelines for collaborators to follow will help facilitate a collaborative and productive forum. For more information on creating community resources, see "Adding a code of conduct to your project," and "Setting guidelines for repository contributors."

When a discussion yields an idea or bug that is ready to be worked on, you can create a new issue from a discussion. For more information, see "Creating an issue."

You can pin a discussion to the top of the list of discussions for the repository or organization. You can also pin a discussion to a specific category. For more information, see "Pinning a discussion."

For more information on facilitating a healthy discussion, see "Moderating comments and conversations."

Para organizar los debates de forma más granular, puedes aplicar etiquetas. Por ejemplo, puedes utilizar etiquetas para indicar el estado de un debate y hacer la clasificación más eficiente. Cada repositorio tiene un conjunto de etiquetas compartidas para las propuestas, solcitudes de cambios y debates. Para más información, vea "Administración de etiquetas".

Prerequisites

To manage discussions in a repository, GitHub Discussions must be enabled for the repository. For more information, see "Enabling or disabling GitHub Discussions for a repository."

To manage discussions in an organization, GitHub Discussions must be enabled for the organization. For more information, see "Enabling or disabling GitHub Discussions for an organization."

Changing the category for a discussion

You can categorize discussions to help community members find related discussions. For more information, see "Managing categories for discussions."

You can also move a discussion to a different category. It's not possible to move a discussion to or from the polls category.

  1. On GitHub.com, navigate to the main page of the repository.

  2. En el nombre de la organización o el repositorio, haz clic en Discussions (Debates). Pestaña "Debates" de un repositorio

  3. En la lista de debates, da clic en el debate que quieras ver. Debate en la lista de debates de un repositorio

  4. In the right sidebar, to the right of "Category", click .

    Screenshot of the "Category" with gear icon

  5. Click a category.

    Screenshot of the "Change category" drop-down menu

Pinning a discussion

You can pin a discussion above the list of discussions for the repository or organization. You can also pin a discussion to a specific category. The globally pinned discussions will be shown in addition to the discussions pinned to a specific category.

This is what it looks like when you have a globally pinned discussion and a discussion pinned to the Ideas category.

Screenshot of a globally pinned discussion and a discussion pinned to the Ideas category

Pinning a discussion globally

You can pin up to four important discussions above the list of discussions for the repository or organization.

  1. On GitHub.com, navigate to the main page of the repository or organization.

  2. En el nombre de la organización o el repositorio, haz clic en Discussions (Debates). Pestaña "Debates" de un repositorio

  3. En la lista de debates, da clic en el debate que quieras ver. Debate en la lista de debates de un repositorio

  4. In the right sidebar, click Pin discussion.

    Screenshot of the "Pin discussion" option in right sidebar for discussion

  5. Optionally, customize the look of the pinned discussion.

    Screenshot of customization options for a pinned discussion

  6. Click Pin discussion.

    Screenshot of the "Pin discussion" button under customization options for pinned discussion

Pinning a discussion to a category

You can pin up to four important discussions above the list of discussions in a specific category.

  1. On GitHub.com, navigate to the main page of the repository or organization.

  2. En el nombre de la organización o el repositorio, haz clic en Discussions (Debates). Pestaña "Debates" de un repositorio

  3. En la lista de debates, da clic en el debate que quieras ver. Debate en la lista de debates de un repositorio

  4. In the right sidebar, click Pin discussion to CATEGORY.

    Screenshot of the "Pin discussion to CATEGORY" option in right sidebar for discussion

  5. To confirm, click Pin to CATEGORY.

    Screenshot of the "Pin discussion to CATEGORY" modal

Editing a pinned discussion

Editing a pinned discussion will not change the discussion's category. For more information, see "Managing categories for discussions."

  1. On GitHub.com, navigate to the main page of the repository or organization.
  2. En el nombre de la organización o el repositorio, haz clic en Discussions (Debates). Pestaña "Debates" de un repositorio
  3. En la lista de debates, da clic en el debate que quieras ver. Debate en la lista de debates de un repositorio
  4. In the right sidebar, click Edit pinned discussion.

Screenshot of the "Edit pinned discussion" option in right sidebar for discussion

  1. Customize the look of the pinned discussion.

    Screenshot of customization options for a pinned discussion

  2. Click Pin discussion.

    Screenshot of the "Pin discussion" button under customization options for pinned discussion

Unpinning a discussion

You can unpin a discussion from the list of discussions for the repository or organization, or from the list of discussions in a specific category.

Unpinning a globally pinned discussion

You can unpin a globally pinned discussion. This will not delete the discussion, but the discussion will no longer be displayed above the list of discussions.

  1. On GitHub.com, navigate to the main page of the repository or organization.

  2. En el nombre de la organización o el repositorio, haz clic en Discussions (Debates). Pestaña "Debates" de un repositorio

  3. En la lista de debates, da clic en el debate que quieras ver. Debate en la lista de debates de un repositorio

  4. In the right sidebar, click Unpin discussion.

    Screenshot of the "Unpin discussion" option in right sidebar for discussion

  5. Read the warning, then click Unpin discussion.

    Screenshot of the "Unpin discussion" button beneath warning in modal

Unpinning a discussion from a category

You can unpin a discussion pinned to a specific category. This will not delete the discussion, but the discussion will no longer be displayed at the top of the category.

  1. On GitHub.com, navigate to the main page of the repository or organization.

  2. En el nombre de la organización o el repositorio, haz clic en Discussions (Debates). Pestaña "Debates" de un repositorio

  3. En la lista de debates, da clic en el debate que quieras ver. Debate en la lista de debates de un repositorio

  4. In the right sidebar, click Unpin discussion from this category.

    Screenshot of the "Unpin discussion from this category" option in right sidebar for discussion

  5. Read the warning, then click Unpin from this category.

    Screenshot of the "Unpin from this category" button in the "Unpin this discussion from this category" modal

Transferring a discussion

To transfer a discussion, you must have permissions to create discussions in the repository where you want to transfer the discussion. If you want to transfer a discussion to an organization, you must have permissions to create discussions in the source repository for the organization's discussions. You can only transfer discussions between repositories owned by the same user or organization account. You can't transfer a discussion from a private repository to a public repository.

  1. On GitHub.com, navigate to the main page of the repository or organization.

  2. En el nombre de la organización o el repositorio, haz clic en Discussions (Debates). Pestaña "Debates" de un repositorio

  3. En la lista de debates, da clic en el debate que quieras ver. Debate en la lista de debates de un repositorio

  4. In the right sidebar, click Transfer this discussion.

    Screenshot of the "Transfer discussion" option in right sidebar for discussion

  5. Select the Choose a repository drop-down, and click the repository you want to transfer the discussion to. If you want to transfer a discussion to an organization, choose the source repository for the organization's discussions.

    Screenshot of the "Choose a repository" drop-down, "Find a repository" search field, and repository in list

  6. Click Transfer discussion.

    Screenshot of the "Transfer discussion" button

Deleting a discussion

  1. On GitHub.com, navigate to the main page of the repository or organization.

  2. En el nombre de la organización o el repositorio, haz clic en Discussions (Debates). Pestaña "Debates" de un repositorio

  3. En la lista de debates, da clic en el debate que quieras ver. Debate en la lista de debates de un repositorio

  4. In the right sidebar, click Delete discussion.

    Screenshot of the "Delete discussion" option in right sidebar for discussion

  5. Read the warning, then click Delete this discussion.

    Screenshot of the "Delete this discussion" button beneath warning in modal

Converting issues based on labels

You can convert all issues with the same label to discussions in bulk. Future issues with this label will also automatically convert to the discussion and category you configure.

  1. On GitHub.com, navigate to the main page of the repository or, for organization discussions, the source repository.

  2. Debajo del nombre del repositorio, haz clic en Propuestas.

    Pestaña de informe de problemas

  3. Encima de la lista de incidencias o solicitudes de incorporación de cambios, haga clic en Labels. Pestaña Labels en la página de incidencias o solicitudes incorporación de cambios de un repositorio

  4. Next to the label you want to convert to issues, click Convert issues.

  5. Select the Choose a category drop-down menu, and click a category for your discussion.

  6. Click I understand, convert this issue to a discussion.