Skip to main content

Guía de inicio rápido para los debates de GitHub

Habilita GitHub Discussions en un repositorio u organización existente e inicia conversaciones con tu comunidad.

Introducción

GitHub Discussions es un foro de comunicación colaborativa para la comunidad que circunda un proyecto interno o de código abierto. Los debates existen para las conversaciones que necesitan ser transparentes y accesibles pero no necesitan rastrearse en un tablero de proyecto y no se relacionan con el código, a diferencia de los GitHub Issues. Los debates habilitan las conversaciones abiertas y fluídas en un foro público.

Los debates proporcionan un espacio para que existan conversaciones colaborativas al conectar y asignar un área más centralizada para conectarse y encontrar información.

Habilitar los GitHub Discussions en tu repositorio

Los propietarios de los repositorios y las personas con acceso de escritura pueden habilitar los GitHub Discussions para una comunidad en sus repositorios públicos y privados. La visibilidad de un debate se hereda del repositorio en el que se crea el debate.

Cuando habilitas los GitHub Discussions por primera vez, se te invitará a configurar una publicación de bienvenida.

  1. En GitHub.com, vaya a la página principal del repositorio.
  2. Debajo del nombre del repositorio, haga clic en Settings (Configuración). Botón de configuración pública
  3. En "Features" (Características), haga clic en Set up discussions (Configurar debates). Botón "Set up discussions" (Configurar debates) en "Features" (Características) para habilitar o deshabilitar los debates de GitHub en un repositorio
  4. Debajo de "Iniciar un debate nuevo" edita la plantilla para que se apegue con los recursos y el tono que quieras configurar para tu comunidad.
  5. Haga clic en Start discussion (Iniciar debate). Botón "Start discussion" (Iniciar debate)

Habilitación de GitHub Discussions en tu organización

Los propietarios de las organizaciones pueden habilitar GitHub Discussions para su organización.

Al habilitar debates de la organización, elegirás un repositorio de la organización a fin de que sea el repositorio de origen para los debates de la organización. Puedes usar un repositorio existente o crear uno específicamente para mantener debates de la organización. Los debates aparecerán en la página de debates de la organización y en la de debate del repositorio de origen.

El permiso para participar en debates o administrarlos en tu organización se basa en el permiso en el repositorio de origen. Por ejemplo, un usuario necesita permiso de escritura en el repositorio de origen para eliminar un debate de la organización. Esto es idéntico a cómo un usuario necesita permiso de escritura en un repositorio para eliminar un debate del repositorio.

Puedes cambiar el repositorio de origen en cualquier momento. Si cambias el repositorio de origen, los debates no se transfieren al nuevo repositorio de origen.

  1. En GitHub.com, ves hasta la página principal de la organización.
  2. En el nombre de la organización, haz clic en Settings (Configuración). Botón de configuración de organización
  3. En "Discussions" (Debates), selecciona Enable discussions for this organization (Habilitar debates para esta organización).
  4. Selecciona un repositorio a fin de usarlo como repositorio de origen para los debates de la organización. Configuración a fin de habilitar debates para una organización
  5. Haga clic en Save(Guardar).

Aceptar contribuyentes en tus debates

Puedes dar la bienvenida a tu comunidad y presentar una forma nueva de comunicarse en un repositorio o una organización si creas una publicación de bienvenida y anclas la publicación a tu página de GitHub Discussions. El fijar y bloquear los debates ayuda a que las personas sepan si una publicación se hizo a manera de anuncio. Puedes utilizar los anuncios como una forma de vincular a las personas con más recursos y ofrecerles orientación para abrir debates en tu comunidad. Para más información sobre cómo anclar un debate, consulta "Administración de debates".

Configurar los lineamientos comunitarios para los contribuyentes

En el caso de los debates de un repositorio, puedes configurar lineamientos de contribución para motivar a los colaboradores para que tengan conversaciones significativas y útiles que sean relevantes para el repositorio. También puedes actualizar el archivo de README del repositorio para comunicar tus expectativas de cuándo deberían los colaboradores abrir una propuesta o un debate. Para obtener más información sobre cómo proporcionar instrucciones para el proyecto, consulta "Adición de un código de conducta al proyecto" y "Configuración del proyecto para colaboraciones correctas".

En el caso de los debates de una organización, compartes información sobre como participar con tu organización si creas un archivo LÉAME de perfil de esta. Para más información, consulta "Personalización del perfil de la organización".

Crear un debate nuevo

Cualquier usuario autenticado que pueda ver un repositorio puede crear un debate en dicho repositorio. Del mismo modo, dado que los debates de una organización se basan en un repositorio de origen, cualquier usuario autenticado que pueda ver el repositorio de origen puede crear un debate en esa organización.

  1. En GitHub.com, ves a la página principal del repositorio o la organización en la que quieres empezar un debate.
  2. En el nombre de la organización o el repositorio, haz clic en Discussions (Debates). Pestaña "Debates" de un repositorio
  3. Haga clic en Nuevo debate. Botón "Nuevo debate" dentro de la pestaña "Debates" de un repositorio
  4. Seleccione el menú desplegable Seleccionar categoría y haga clic en una categoría para el debate. Menú desplegable "Seleccionar categoría" y lista de categorías disponibles en un repositorio
  5. Teclea un título y cuerpo para tu debate. Campos de texto para el cuerpo y título de un debate nuevo
  6. Haga clic en Iniciar debate. Botón "Iniciar debate"

Creación de un sondeo

Cualquier usuario autenticado que pueda ver un repositorio puede crear un sondeo. Del mismo modo, dado que los debates de una organización se basan en un repositorio de origen, cualquier usuario autenticado que pueda ver el repositorio de origen puede crear un sondeo en esa organización.

  1. En GitHub.com, vaya a la página principal del repositorio. 1. En el nombre de la organización o el repositorio, haz clic en Discussions (Debates). Pestaña "Debates" de un repositorio
  2. En la lista de categorías, haz clic en Sondeos. Captura de pantalla que muestra la categoría "Sondeo"
  3. A la derecha, haz clic en Iniciar sondeo. Captura de pantalla que muestra el botón "Iniciar sondeo"
  4. Escribe un título y un cuerpo opcional para el sondeo. Captura de pantalla que muestra los campos de texto para el título y el cuerpo
  5. Escribe una pregunta para el sondeo. Captura de pantalla que muestra los campos de texto para la pregunta del sondeo
  6. Escribe al menos dos opciones para el sondeo. Captura de pantalla que muestra los campos de texto para las opciones del sondeo
  7. Opcionalmente, para agregar opciones de sondeo adicionales, haz clic en Agregar una opción. Captura de pantalla que muestra el botón "Agregar una opción"
  8. Haz clic en Iniciar sondeo. Captura de pantalla que muestra el botón "Iniciar sondeo"

Organizar debates

Los propietarios de un repositorio y las personas que tienen acceso de escritura al mismo pueden crear categorías nuevas para mantener los debates organizados. Del mismo modo, dado que los debates de una organización se basan en un repositorio de origen, los propietarios del repositorio y las personas que tienen acceso de escritura al repositorio de origen pueden crear categorías para los debates de una organización.

Los colaboradores que participen y creen debates nuevos pueden agruparlos en las categorías existentes más relevantes. Los debates también pueden volver a categorizarse después de su creación. Para más información, consulta "Administración de categorías para debates".

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".

Promover las conversaciones sanas

Las personas que tienen permisos de escritura en el repositorio, o bien en el repositorio de origen para los debates de una organización, pueden ayudar a que las conversaciones importantes emerjan si anclan los debates, borran aquellos que ya no son útiles o que dañan a la comunidad, y transfieren aquellos a repositorios más pertinentes que pertenezcan a la organización. Para más información, consulta "Administración de debates".

Las personas con permisos de evaluación de prioridades en el repositorio, o bien en el repositorio de origen para los debates de una organización, pueden ayudar a moderar los debates de un proyecto si marcan los comentarios como respuestas, bloquean los debates que ya no son útiles o que dañan a la comunidad, y convierten las incidencias en debates cuando una idea aún se encuentra en una etapa de desarrollo temprana. Para más información, vea "Moderación de debates".

Pasos siguientes

Una vez que exista una ruta clara para ampliar el alcance del trabajo y migrar una idea desde un concepto hacia la realidad, puedes crear una propuesta y comenzar a rastrear tu progreso. Para obtener más información sobre cómo crear una incidencia a partir de un debate, vea "Moderación de debates".