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.
- On GitHub.com, navigate to the main page of the repository.
- Debajo del nombre del repositorio, haga clic en Settings (Configuración).
- En "Features" (Características), haga clic en Set up discussions (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).
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.
- On GitHub.com, navigate to the main page of your organization.
- Under your organization name, click
Settings.
- Under "Discussions", select Enable discussions for this organization.
- Select a repository to use as the source repository for your organization discussions.
- 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.
- On GitHub.com, navigate to the main page of the repository or organization where you want to start a discussion.
- En el nombre de la organización o el repositorio, haz clic en Discussions (Debates).
- Click New discussion.
- Select the Select Category drop-down menu, and click a category for your discussion.
- Type a title and body for your discussion.
- Click Start discussion.
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.
- 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).
- En la lista de categorías, haz clic en Sondeos.
- A la derecha, haz clic en Iniciar sondeo.
- Escribe un título y un cuerpo opcional para el sondeo.
- Escribe una pregunta para el sondeo.
- Escribe al menos dos opciones para el sondeo.
- Opcionalmente, para agregar opciones de sondeo adicionales, 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 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".