Acerca de GitHub Discussions
Con GitHub Discussions, la comunidad de tu proyecto puede crear y participar en conversaciones dentro del repositorio del proyecto u organización. Los debates fotalecen a los mantenedores del proyecto, contribuyentes y visitantes para que se reunan y logren sus metas en una ubicación centralizada, sin herramientas de terceros.
- Comparte anuncios e información, recolecta comentarios, planea y toma decisiones
- Haz preguntas, debate y respóndelas, y marca los debates como respondidos
- Creación de sondeos para medir la opinión de la comunidad
- Vota a favor de debates y comentarios para dar mayor visibilidad a ideas que te parezcan valiosas.
- Fomenta un ambiente amigable para los visitantes y contribuyentes para que se debatan las metas, el desarrollo, la administración y los flujos de trabajo
Puedes usar los debates del repositorio para analizar temas específicos del repositorio. Si el proyecto abarca varios repositorios, puedes usar debates de la organización para analizar temas que no son específicos de un único repositorio de la organización.
Una discusión se puede cerrar cuando se haya resuelto, cuando ya no sea relevante o cuando sea un duplicado. Para más información, consulta Cierre de un debate.
Si un administrador de repositorio o mantenedor de proyecto habilita los GitHub Discussions para un repositorio, cualquiera que tenga acceso al repositorio podrá crear y participar en los debates de este. Si un propietario de la organización habilita GitHub Discussions para una organización, cualquier persona que pueda ver el repositorio de origen puede crear un debate de la organización.
Los administradores del repositorio y los mantenedores del proyecto pueden administrar los debates y las categorías de los mismos en un repositorio y fijarlos para incrementar la visibilidad de éstos. Los moderadores y colaboradores pueden marcar los comentarios como respuestas, fijar debates, y convertir las propuestas en debates. Del mismo modo, para los debates de la organización, el rol de un usuario en el repositorio de origen determina el modo en que un usuario puede interactuar con los debates de la organización. Para más información, consulta Roles de repositorio para una organización.
Para más información sobre la administración de debates, consulta Administrar los debates.
Acerca de los sondeos
Puedes crear sondeos en la categoría de sondeos para medir el interés en las nuevas ideas y la dirección del proyecto. Cualquier persona con acceso de lectura al repositorio puede crear sondeos, votar en sondeos y ver sus resultados.
Los sondeos requieren una pregunta y al menos dos opciones. Puedes agregar un máximo de 8 opciones y las opciones pueden contener un máximo de 128 caracteres.
Los votantes no pueden cambiar su voto. La edición de un sondeo restablecerá los votos que ya se hayan emitido.
Para más información sobre cómo crear sondeos, consulta Participar en un debate.
Acerca de la organización de debates
Puedes organizar discusiones con categorías,secciones y etiquetas.
Puedes categorizar debates para ayudar a los miembros de la comunidad a iniciar conversaciones en el lugar correcto y para ayudar los a encontrar los debates relacionados. Todos los debates deben crearse en una categoría. En el caso de los debates del repositorio, las personas con permisos de mantenedor o administrador en el repositorio definen las categorías de los debates de dicho repositorio. En el caso de los debates de la organización, las personas con permisos de mantenedor o administrador en el repositorio de origen definen las categorías de los debates de dicha organización. Cada categoría tiene un formato: debate abierto, pregunta y respuesta o anucio. Cada repositorio u organización puede tener hasta 25 categorías.
Para los debates con un formato de pregunta/respuesta, un comentario individual dentro del debate puede marcarse como la respuesta a éste. GitHub reconocerá automáticamente a aquellos miembros de la comunidad que contribuyan a los debates de formato pregunta/respuesta con más comentarios marcados como respuesta.
Los mantenedores pueden utilizar categorías con el formato de anuncio para compartir información, lanzamientos o eventos. Para mantener a los debates de estas categorías con un enfoque en las actualizaciones importantes, solo las personas con permisos de mantenedor o administrador pueden crear debates, pero cualquiera puede comentar y responder.
Para organizar mejor las discusiones, puedes crear secciones y, a continuación, anidar las categorías dentro de una secció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 obtener más información, vea «Administrar las etiquetas».
Mejores prácticas para los GitHub Discussions
Como mantenedor o miembro de la comunidad, inicia un debate para hacer una pregunta o debatir información que les afecte. Para más información, consulta Colaborar con los mantenedores utilizando debates.
Participa en un debate para hacer y responder preguntas, proporcionar retroalimentación e interactuar con la comunidad del proyecto. Para más información, consulta Participar en un debate.
Puedes destacar los debates que contengan conversaciones importantes, útiles o ejemplares entre los miembros de la comunidad. Para más información, consulta Administrar los debates.
Si una propuesta resulta ser una pregunta o una conversación abierta en vez de un elemento de trabajo para rastrear y priorizar, puedes convertirla en un debate. Para obtener más información, consulta Moderar los debates.
Compartir la retroalimentación
Puedes compartir tu retroalimentación sobre los GitHub Discussions con GitHub. Para unirte a la conversación, consulta los debates GitHub Community.