Introducción
GitHub Discussions es un foro de comunicación colaborativa para la comunidad que circunda un proyecto 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 Propuestas de GitHub. 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 privados o públicos.
Cuando habilitas los GitHub Discussions por primera vez, se te invitará a configurar una publicación de bienvenida.
- En GitHub.com, visita la página principal del repositorio.
- Debajo de tu nombre de repositorio, da clic en Configuración.
- Debajo de "Características", da 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.
- Da clic en Iniciar debate.
Aceptar contribuyentes en tus debates
Puedes dar la bienvenida a tu comunidad e introducir una forma nueva de comunicarse en un repositorio 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 fijar un debate, consulta la sección "Administrar los debates en tu repositorio".
Configurar los lineamientos comunitarios para los contribuyentes
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 proporcionar lineamientos para tu proyecto, consulta las secciones "Agregar un código de conducta a tu proyecto" y "Configurar tu proyecto para que tegan contribuciones sanas".
Crear un debate nuevo
Cualquier usuario autenticado que pueda ver un repositorio puede crear un debate.
- En GitHub.com, visita la página principal del repositorio.
- Debajo de tu nombre de repositorio, da clic en Debates.
- Da clic en Debate nuevo.
- Selecciona el menú desplegable de Seleccionar categoría y da clic en una categoría para tu debate.
- Teclea un título y cuerpo para tu debate.
- Da clic en Iniciar debate.
Organizar debates
Los propietarios de los repositorios y las personas con acceso de escritura pueden crear categorías nuevas para mantener los debates organizados. 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, consulta la sección "Administrar las categorías para los debates en tu repositorio".
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, consulta la sección "Administrar etiquetas".
Promover las conversaciones sanas
Las personas con permisos de escritura en un repositorio pueden ayudar a que las conversaciones importantes emerjan fijando los debates, borrando aquellos que ya no sean útiles o que dañen a la comunidad, y transfiriendo aquellos a repositorios más relevantes que pertenezcan a la organización. Para obtener más información, consulta la sección "Administrar los debates en tu repositorio".
Las personas con permisos de clasificación en un repositorio pueden ayudar a moderar los debates de un proyecto si marcan los comentarios como respuestas, fijar los debates que ya no son útiles o que están haciendo daño a la comunidad, y convertir las propuestas en debates cuando una idea aún se encuentra en una etapa temprana de desarrollo. Para obtener más información, consulta la sección "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 propuesta a partir de un debate, consulta la sección "Moderar debates".