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

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, navega a la página principal del repositorio.

2. Debajo del nombre del repositorio, haga clic en Configuración.

   

3. Desplázate hacia abajo hasta la sección "Características" y haz clic en Configurar debates.

   

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

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, ve a la página principal de la organización.

2. En el nombre de la organización, haz clic en Settings (Configuración).

   

3. En "Discussions" (Debates), selecciona Enable discussions for this organization (Habilitar debates para esta organización).

4. Usa el menú desplegable para seleccionar un repositorio que se usará como repositorio de origen para los debates de la 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 obtener más información sobre cómo anclar un debate, consulta "Administrar los 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 "Agregar un código de conducta a tu proyecto" y "Configurar tu proyecto para contribuciones saludables".

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 obtener más información, vea «Personalizar el perfil de tu 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, navega 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).

   

3. En el lado derecho de la página, haz clic en Nueva discusión.

4. Selecciona una categoría de discusión haciendo clic en Comenzar.

   

5. En "Título de la discusión", escribe un título para la discusión y, en "Escribir", escribe el cuerpo de la discusión.

   

6. Haga clic en Start discussion (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, navega a la página principal del repositorio. 1. En el nombre de la organización o el repositorio, haz clic en Discussions (Debates).

   

2. En la lista de categorías, haz clic en Sondeos.

   

3. A la derecha, haz clic en Nueva discusión.

4. En "Título de la discusión", escribe un título y, opcionalmente, en "Escribir", escribe un cuerpo para el sondeo.

   

5. En "Pregunta de sondeo", escribe una pregunta para el sondeo.

6. En "Opciones de sondeo", escribe al menos dos opciones para el sondeo.

7. Opcionalmente, para agregar una opción de sondeo adicional, haz clic en Agregar una opción.

   

8. Haz clic en 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 obtener más información, vea «Administración de categorías de debate».

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

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 obtener más información, vea «Administrar los 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 obtener más información, vea «Moderar los 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, consulta "Moderar los debates".