Introducción
GitHub Discussionses un foro de comunicación colaborativa para la comunidad en torno a un proyecto código abierto o interno. Los debates sirven para conversaciones que deben ser transparentes y accesibles, pero que no necesitan seguimiento en un proyecto y no están relacionadas con código, a diferencia de 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 GitHub Discussions en tu repositorio
Los propietarios de repositorios y las personas con acceso de escritura pueden habilitar 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 habilite GitHub Discussionspor primera vez , se le invitará a configurar una publicación de bienvenida.
- En GitHub, navegue hasta la página principal del repositorio.
- En el nombre del repositorio, haga clic en
Configuración.
-
Desplázate hacia abajo hasta la sección "Características" y haz clic en Configurar debates.
-
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.
-
Haga clic en Start discussion (Iniciar debate).
Activar GitHub Discussions en su organización
Los propietarios de la organización 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.
-
En GitHub, navega a la página principal de tu organización.
-
En el nombre de la organización, haz clic en Settings (Configuración).
-
En "Discussions" (Debates), selecciona Enable discussions for this organization (Habilitar debates para esta organización).
-
Usa el menú desplegable para seleccionar un repositorio que se usará como repositorio de origen para los debates de la organización.
-
Haga clic en Save(Guardar).
Aceptar contribuyentes en tus debates
Puede dar la bienvenida a su comunidad e introducir una nueva forma de comunicarse en un repositorio u organización mediante la creación de una publicación de bienvenida y la asignación de la publicación a la GitHub Discussions página. 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, consulte Agregar un código de conducta a tu proyecto y Configurar tu proyecto para contribuciones saludables.
Para las discusiones dentro de la organización, compartes información sobre cómo interactuar con tu organización creando un archivo README de perfil de la organización. Para más información, consulta 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.
-
En GitHub, ves a la página principal del repositorio o la organización en la que quieres empezar un debate.
-
En el nombre de la organización o el repositorio, haz clic en Discussions.
-
En el lado derecho de la página, haz clic en Nueva discusión.
-
Selecciona una categoría de discusión haciendo clic en Comenzar.
-
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.
-
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.
-
En GitHub, navegue hasta la página principal del repositorio.
-
En el nombre de la organización o el repositorio, haz clic en Discussions.
-
En la lista de categorías, haz clic en Sondeos.
-
A la derecha, haz clic en Nueva discusión.
-
En "Título de la discusión", escribe un título y, opcionalmente, en "Escribir", escribe un cuerpo para el sondeo.
-
En "Pregunta de sondeo", escribe una pregunta para el sondeo.
-
En "Opciones de sondeo", escribe al menos dos opciones para el sondeo.
-
Opcionalmente, para agregar una opción de sondeo adicional, haz clic en Agregar una opción.
-
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 más información, consulta 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 más información, consulta 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 más información, consulta 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 más información, consulta Moderar los debates.
Pasos siguientes
Una vez que exista una ruta clara para definir el alcance del trabajo y llevar una idea desde un concepto a la realidad, puedes crear un problema y comenzar a rastrear tu progreso. Para obtener más información sobre cómo crear una incidencia desde una discusión, consulta Moderar los debates.