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. On GitHub.com, navigate to the main page of the repository.
  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. On GitHub.com, navigate to the main page of your organization.
  2. Under your organization name, click Settings. Organization settings button
  3. Under "Discussions", select Enable discussions for this organization.
  4. Select a repository to use as the source repository for your organization discussions. Settings to enable discussions for an organization
  5. Click Save.

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. On GitHub.com, navigate to the main page of the repository or organization where you want to start a discussion.
  2. En el nombre de la organización o el repositorio, haz clic en Discussions (Debates). Pestaña "Debates" de un repositorio
  3. Click New discussion. "New discussion" button within the "Discussions" tab for a repository
  4. Select the Select Category drop-down menu, and click a category for your discussion. "Select Category" drop-down menu and list of available categories in a repository
  5. Type a title and body for your discussion. Text fields for new discussion's title and body
  6. Click Start discussion. "Start discussion" button

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. On GitHub.com, navigate to the main page of the repository. 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".