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

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.
3. Debajo de "Características", da clic en Configurar debates.
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.

Enabling GitHub Discussions on your organization

Organization owners can enable GitHub Discussions for their organization.

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.
3. Under "Discussions", select Enable discussions for this organization.
4. Select a repository to use as the source repository for your organization discussions.
5. Haz clic en Save (guardar).

Aceptar contribuyentes en tus debates

You can welcome your community and introduce a new way to communicate in a repository or organization by creating a welcome post and pinning the post to your GitHub Discussions page. 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. For more information about pinning a discussion, see "Managing discussions."

Configurar los lineamientos comunitarios para los contribuyentes

For repository discussions, you can set contributing guidelines to encourage collaborators to have meaningful, useful conversations that are relevant to the repository. 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".

For organization discussions, you share information about how to engage with your organization by creating an organization profile README. Para obtener más información, consulta la sección "Personalizar el perfil de tu organización ".

Crear un debate nuevo

Any authenticated user who can view the repository can create a discussion in that repository. Similarly, since organization discussions are based on a source repository, any authenticated user who can view the source repository can create a discussion in that organization.

1. Activado GitHub.com, navigate to the main page of the repository or organization where you want to start a discussion.
2. Under your repository or organization name, click Discussions.
3. Da clic en Debate nuevo.
4. Selecciona el menú desplegable de Seleccionar categoría y da clic en una categoría para tu debate.
5. Teclea un título y cuerpo para tu debate.
6. Da clic en Iniciar debate.

Creating a new poll

Any authenticated user who can view a repository can create a poll. Similarly, since organization discussions are based on a source repository, any authenticated user who can view the source repository can create a poll in that organization.

1. En GitHub.com, visita la página principal del repositorio.
2. Under your repository or organization name, click Discussions.
3. In the list of categories, click Polls.
4. On the right, click Start poll.
5. Type a title and optional body for your poll.
6. Type a question for your poll.
7. Type at least two options for your poll.
8. Optionally, to add a extra poll options, click Add an option.
9. Click Start poll.

Organizar debates

Repository owners and people with write access to the repository can create new categories to keep discussions organized. Similarly, since organization discussions are based on a source repository, repository owners and people with write access to the source repository can create new categories for organization discussions.

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. For more information, see "Managing categories for discussions."

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

People with write permissions for the repository, or for the source repository for organization discussions, can help surface important conversations by pinning discussions, deleting discussions that are no longer useful or are damaging to the community, and transferring discussions to more relevant repositories owned by the organization. For more information, see "Managing discussions."

People with triage permissions for the repository, or for the source repository for organization discussions, can help moderate a project's discussions by marking comments as answers, locking discussions that are no longer useful or are damaging to the community, and converting issues to discussions when an idea is still in the early stages of development. 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".