Skip to main content

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

Habilita los GitHub Discussions en un repositorio u organización e inicia conversaciones con tu comunidad.

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.

  1. En GitHub.com, visita la página principal del repositorio.
  2. Debajo de tu nombre de repositorio, da clic en Configuración. Botón de configuración pública
  3. Debajo de "Características", da clic en Configurar debates. Configurar un botón de debate debajo de las "Características" para habilitar o inhabilitar los debates de GitHub en un repositorio
  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. Da clic en Iniciar debate. Botón de "Iniciar debate"

Habilitar los GitHub Discussions en tu organización

Los propietarios de las organizaciones pueden habilitar los GitHub Discussions para su organización.

When you enable organization discussions, you will choose a repository in the organization to be the source repository for your organization discussions. You can use an existing repository or create a repository specifically to hold your organization discussions. Discussions will appear both on the discussions page for the organization and on the discussion page for the source repository.

Permission to participate in or manage discussion in your organization is based on permission in the source repository. For example, a user needs write permission to the source repository in order to delete an organization discussion. This is identical to how a user needs write permission in a repository in order to delete a repository discussion.

You can change the source repository at any time. If you change the source repository, discussions are not transferred to the new source repository.

  1. En GitHub.com, navega a la página principal de tu organización.
  2. Under your organization name, click Settings. Botón de configuración de organización
  3. Under "Discussions", select Enable discussions for this organization.
  4. Select a repository to use as the source repository for your organization discussions. Settings to enable discussions for an organization
  5. Haz clic en Save (guardar).

Aceptar contribuyentes en tus debates

Puedes darles la bienvenida a tu comunidad y presentarles una forma nueva de comunicarse en un repositorio u organización si creas una publicación de bienvenida y la anclas 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".

Configurar los lineamientos comunitarios para los contribuyentes

En el caso de los debates de repositorio, puedes configurar lineamientos de contribución para fomentar que los colaboradores tengan conversaciones útiles y significativas 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".

Para el caso de los debates, puedes compartir información sobre cómo participar en tu organización al crear un README de perfil para ella. Para obtener más información, consulta la sección "Personalizar el perfil de tu organización ".

Crear un debate nuevo

Cualquier usuario sin autenticar que pueda ver el repositorio podrá crear un debate en este. De la misma manera, ya que los debates de las organizaciones se basan en un repositorio origen, cualquier usuario autenticado que pueda ver dicho repositorio podrá crear un debate en esta organización.

  1. En GitHub.com, navega a la página principal del repositorio u organización en donde quieras iniciar un debate.
  2. Debajo de tu nombre de organización o repositorio, haz clic en Debates. Pestaña de "Debates" en un repositorio
  3. Da clic en Debate nuevo. Botón de "Debate nuevo" dentro de la pestaña de "Debates" en un repositorio
  4. Selecciona el menú desplegable de Seleccionar categoría y da clic en una categoría para tu debate. Menú desplegable de "Seleccionar categoría" y lista de categorías disponibles en un repositorio
  5. Teclea un título y cuerpo para tu debate. Los campos de texto para el cuerpo y título de un debate nuevo
  6. Da clic en Iniciar debate. Botón de "Iniciar debate"

Crear una encuesta nueva

Cualquier usuario no autenticado que pueda ver un repositorio podrá crear una encuesta. De la misma manera, ya que los debates de las organizaciones se basan en un repositorio origen, cualquier usuario autenticado que pueda ver dicho repositorio podrá crear una encuesta en esta organización.

  1. En GitHub.com, visita la página principal del repositorio.
  2. Debajo de tu nombre de organización o repositorio, haz clic en Debates. Pestaña de "Debates" en un repositorio
  3. In the list of categories, click Polls. Screenshot showing "Poll" category
  4. On the right, click Start poll. Screenshot showing the "Start poll" button
  5. Type a title and optional body for your poll. Screenshot showing text fields for title and body
  6. Type a question for your poll. Screenshot showing text fields for the poll's question
  7. Type at least two options for your poll. Screenshot showing text fields for the poll's options
  8. Optionally, to add a extra poll options, click Add an option. Screenshot showing "Add an option" button
  9. Click Start poll. Captura de pantalla que muestra el botón "Iniciar encuesta"

Organizar debates

Los propietarios de los repositorios y las personas con acceso de escritura en estos pueden crear categorías nuevas para mantener los debates organizados. De la misma manera, ya que los debates de las organizaciones se basan en un repositorio origen, los propietarios de los repositorios y las personas con acceso de escritura con acceso de escritura en el repositorio origen pueden crear categorías nuevas para estos debates.

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 de los 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 obtener más información, consulta la sección "Administrar etiquetas".

Promover las conversaciones sanas

Las personas con permisos de escritura en el repositorio o en el repositorio origen para los debates de las organizaciones pueden ayudar a que se noten las conversaciones importantes si las fijan, borran las que ya no son útiles o que dañan a la comunidad y las transfieren a los repositorios más relevantes que le pertenezcan a la organización. Para obtener más información, consulta la sección "Administrar los debates".

Las personas con permiso de clasificación en el repositorio o en el repositorio origen de los debates de la organización pueden ayudar a moderar los debates de un proyecto al marcar los comentarios como respuestas, fijar los debates que ya no son útiles o que dañan a la comunidad y convertir las propuestas en debates cuando una idea aún está en las primeras etapas 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".