Administrar los debates

Puedes categorizar, resaltar, transferir o borrar los debates.

¿Quién puede utilizar esta característica?

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

En este artículo

Acerca de la administración de los debates

Los GitHub Discussions son un foro abierto para tener conversaciones entre los mantenedores y la comunidad para un repositorio u organización en GitHub. Para obtener más información, consulta Acerca de los debates.

Los propietarios de la organización pueden elegir los permisos que se requieren para crear un debate en los repositorios que pertenezcan a la organización. Del mismo modo, para elegir los permisos necesarios para crear un debate de la organización, los propietarios de la organización pueden cambiar los permisos necesarios en el repositorio de origen. Para más información, consulta Administrar la creación de debates para los repositorios de tu organización.

Como mantenedor de debates, puedes crear recursos comunitarios para impulsar los debates que se alinien con la meta general del proyecto y mantener así un foro abierto y amistoso para los colaboradores. La creación de un código de conducta o directrices de colaboración para que los colaboradores los sigan te ayudará a proporcionar un foro colaborativo y productivo. Para obtener más información sobre cómo crear recursos de la comunidad, consulta Agregar un código de conducta a tu proyecto y Configurar pautas para los colaboradores de repositorios.

Cuando un debate produce una idea o error que está listo para solucionarse, puedes crear una propuesta nueva desde un debate. Para más información, consulta Crear una propuesta.

Puedes anclar un debate a la parte superior de la lista de debates para el repositorio o la organización. También puedes anclar un debate a una categoría específica. Para obtener más información, consulta Administrar los debates.

Para obtener más información sobre cómo facilitar un debate correcto, consulta Moderar comentarios y conversaciones.

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 obtener más información, vea «Administrar las etiquetas».

Prerrequisitos

Para administrar los debates en un repositorio, debes habilitar los GitHub Discussions en este. Para más información, consulta Habilita o inhabilita los debates de GitHub para un repositorio.

Para administrar debates en una organización, los datos GitHub Discussions debe estar habilitados para la organización. Para más información, consulta Habilitación o deshabilitación de los debates de GitHub para una organización.

Cambiar la categoría de un debate

Puedes categorizar los debates para ayudar a que los miembros de la comunidad encuentren aquellos que tengan alguna relación. Para más información, consulta Administración de categorías de debate.

También puedes migrar un debate a una categoría diferente. No es posible mover un debate a o desde la categoría de sondeos.

  1. En GitHub, navegue hasta la página principal del repositorio.

  2. En el nombre de la organización o el repositorio, haz clic en Debates.

    Captura de pantalla de las pestañas de un repositorio de GitHub. La opción "Debates" está resaltada en naranja oscuro.

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

  4. En la barra lateral derecha, a la derecha de "Categoría", haz clic en .

  5. Haz clic en una categoría.

Fijar un debate

Puedes anclar un debate encima de la lista de debates para el repositorio o la organización. También puedes anclar un debate a una categoría específica. Los debates anclados globalmente se mostrarán además de los debates anclados a una categoría específica.

Así es como se ve cuando tienes un debate anclado globalmente y un debate anclado a la categoría Ideas.

Captura de pantalla de un debate anclado globalmente y un debate anclado a la categoría Ideas.

Anclaje de un debate globalmente

Puedes fijar hasta cuatro debates importantes sobre la lista de debates del repositorio u organización.

  1. En GitHub, navegue hasta la página principal del repositorio o la organización.

  2. En el nombre de la organización o el repositorio, haz clic en Debates.

    Captura de pantalla de las pestañas de un repositorio de GitHub. La opción "Debates" está resaltada en naranja oscuro.

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

  4. En la barra lateral derecha, haz clic en Anclar debate.

    Captura de pantalla de la barra lateral derecha de un debate. La opción "Anclar debate" está resaltada con un contorno naranja.

  5. Opcionalmente, personaliza la apariencia del debate que fijaste.

  6. Haga clic en Pin discussion (Anclar debate).

Anclaje de un debate a una categoría

Puedes anclar hasta cuatro debates importantes sobre la lista de debates en una categoría específica.

  1. En GitHub, navegue hasta la página principal del repositorio o la organización.

  2. En el nombre de la organización o el repositorio, haz clic en Debates.

    Captura de pantalla de las pestañas de un repositorio de GitHub. La opción "Debates" está resaltada en naranja oscuro.

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

  4. En la barra lateral derecha, haz clic en Anclar debate a CATEGORÍA.

    Captura de pantalla de la barra lateral derecha de un debate. La opción "Anclar discusión a Q&A" se destaca en naranja oscuro.

  5. Para confirmarlo, haz clic en Anclar a CATEGORÍA.

Editar un debate que se fijó

Editar un debate que se ha fijado no cambiará la categoría del mismo. Para más información, consulta Administración de categorías de debate.

  1. En GitHub, navegue hasta la página principal del repositorio o la organización.

  2. En el nombre de la organización o el repositorio, haz clic en Debates.

    Captura de pantalla de las pestañas de un repositorio de GitHub. La opción "Debates" está resaltada en naranja oscuro.

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

  4. En la barra lateral derecha, haz clic en Editar debate anclado.

    Captura de pantalla de la barra lateral derecha de un debate. La opción "Editar discusión anclada" se destaca en naranja oscuro.

  5. Personaliza la apariencia del debate que fijaste.

  6. Haga clic en Pin discussion (Anclar debate).

Dejar de fijar un debate

Puedes desanclar un debate de la lista de debates para el repositorio o la organización, o bien de la lista de debates de una categoría específica.

Desanclaje de un debate anclado globalmente

Puedes desanclar un debate anclado globalmente. Esto no eliminará el debate, pero este ya no se mostrará encima de la lista de debates.

  1. En GitHub, navegue hasta la página principal del repositorio o la organización.

  2. En el nombre de la organización o el repositorio, haz clic en Debates.

    Captura de pantalla de las pestañas de un repositorio de GitHub. La opción "Debates" está resaltada en naranja oscuro.

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

  4. En la barra lateral derecha, haz clic en Desanclar debate.

    Captura de pantalla de la barra lateral derecha de un debate. La opción "Desanclar discusión" aparece resaltada con un contorno naranja.

  5. Lea la advertencia y haga clic en Unpin discussion (Desanclar debate).

Desanclaje de un debate de una categoría

Puedes desanclar un debate anclado a una categoría específica. Esto no eliminará el debate, pero este ya no se mostrará encima de la categoría.

  1. En GitHub, navegue hasta la página principal del repositorio o la organización.

  2. En el nombre de la organización o el repositorio, haz clic en Debates.

    Captura de pantalla de las pestañas de un repositorio de GitHub. La opción "Debates" está resaltada en naranja oscuro.

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

  4. En la barra lateral derecha, haz clic en Desanclar debate de esta categoría.

    Captura de pantalla de la barra lateral derecha de un debate. La opción "Desanclar discusión de esta categoría" se destaca en naranja oscuro.

  5. Lee la advertencia y, a continuación, haz clic en Desanclar de esta categoría.

Transferir un debate

Para transferir un debate, debes tener permisos para crear debates en el repositorio a donde quieras trasnferirlo. Si quieres transferir un debate a una organización, debes tener permisos para crear debates en el repositorio de origen para los debates de la organización. Solo puedes transferir debates entre los repositorios que pertenezcan a la misma cuenta de organización o de usuario. No se puede transferir un debate de un repositorio privado a un repositorio público. Además, no puede transferir discusiones si son anuncios. Para más información, consulta Administración de categorías de debate.

  1. En GitHub, navegue hasta la página principal del repositorio o la organización.

  2. En el nombre de la organización o el repositorio, haz clic en Debates.

    Captura de pantalla de las pestañas de un repositorio de GitHub. La opción "Debates" está resaltada en naranja oscuro.

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

  4. En la barra lateral derecha, haz clic en Transferir este debate.

    Captura de pantalla de la barra lateral derecha de un debate. La opción "Transferir esta discusión" se destaca en naranja oscuro.

  5. Selecciona el repositorio al que quieres transferir el debate. También puedes buscar repositorios. Si deseas transferir un debate a una organización, elige el repositorio de origen para los debates de la organización.

  6. Haga clic en Transfer discussion (Transferir debate).

Borrar un debate

  1. En GitHub, navegue hasta la página principal del repositorio o la organización.

  2. En el nombre de la organización o el repositorio, haz clic en Debates.

    Captura de pantalla de las pestañas de un repositorio de GitHub. La opción "Debates" está resaltada en naranja oscuro.

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

  4. En la barra lateral derecha, haz clic en Eliminar debate.

    Captura de pantalla de la barra lateral derecha de un debate. La opción "Eliminar discusión" se destaca en naranja oscuro.

  5. Lea la advertencia y haga clic en Delete this discussion (Eliminar este debate).

Cierre de un debate

Una discusión se puede cerrar cuando se haya resuelto, cuando ya no sea relevante o cuando sea un duplicado.

  1. En GitHub, navegue hasta la página principal del repositorio o la organización.

  2. En el nombre de la organización o el repositorio, haz clic en Debates.

    Captura de pantalla de las pestañas de un repositorio de GitHub. La opción "Debates" está resaltada en naranja oscuro.

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

  4. En la parte inferior del debate, debajo del cuadro de comentarios, haz clic en Cerrar debate.

  5. Opcionalmente, para cambiar el motivo del cierre del debate, selecciona el menú desplegable junto a "Cerrar debate" y haz clic en un motivo.

Convertir propuestas con base en las etiquetas

Puedes convertir todas las propuestas con la misma etiqueta en debates, por lote. Las propuestas subsecuentes que tengan esta etiqueta también se convertirán automáticamente en el debate y categoría que configures.

  1. Vaya a la página principal del repositorio o, para los debates de la organización, al repositorio de origen.

  2. Debajo del nombre del repositorio, haga clic en Problemas.

    Captura de pantalla de la página principal de un repositorio. En la barra de navegación horizontal, una pestaña, con la etiqueta "Problemas", se destaca en naranja oscuro.

  3. Encima de la lista de incidencias o solicitudes de incorporación de cambios, haga clic en Labels.

    Captura de pantalla de la lista de problemas de un repositorio. Encima de la lista, un botón, etiquetado con un icono de etiqueta y "Etiquetas", se resalta en naranja oscuro.

  4. Junto a la etiqueta que quiere convertir en incidencias, haga clic en Convert issues (Convertir incidencias).

  5. Seleccione el menú desplegable Choose a category (Seleccionar una categoría) y haga clic en una categoría para el debate.

  6. Haga clic en I understand, convert this issue to a discussion (Lo entiendo, convertir esta incidencia en un debate).