Comunicarse con GitHub

Introducción

GitHub proporciona herramientas de comunicación colaborativa integradas que le permiten interactuar estrechamente con su comunidad. Esta guía de inicio rápido te mostrará cómo escoger la herramienta correcta para tus necesidades.

Puedes crear y participar de propuestas, solicitudes de extracción y debates de equipos, dependiendo del tipo de conversación que quieras tener.

GitHub Issues

• Son útiles para debatir los detalles específicos de un proyecto, tales como informes de errores, mejoras planeadas y retroalimentación
• Son específicas de un repositorio y, habitualmente, es claro quién es el propietario
• A menudo se les denomina el sistema de seguimiento de errores de GitHub

Solicitudes de incorporación de cambios

• Te permiten proponer cambios específicos
• Te permiten comentar directamente sobre los cambios propuestos que otros sugieren
• Son específicos de un repositorio

GitHub Discussions

• Son como un foro y son muy útiles para ideas y debates abiertos en donde es importante la colaboración
• Pueden abarcar muchos repositorios
• Proporcionan una experiencia colaborativa fuera de la base de código, lo cual permite la lluvia de ideas y la creación de una base de conocimiento comunitario
• A menudo no se sabe quién es el propietario
• A menudo no da lugar a una tarea accionable

¿Qué herramienta de discusión debería utilizar?

Escenarios de problemas

• Quiero dar seguimiento a las tareas, ampliaciones y errores.
• Quiero emitir un reporte de errores.
• Quiero compartir retroalimentación sobre una característica específica.
• Quiero hacer una pregunta sobre los archivos del repositorio.

Ejemplo de propuesta

En este ejemplo se muestra cómo un GitHub usuario creó un problema en nuestra documentación código abierto repositorio para hacernos conscientes de un error y analizar una corrección.

• Un usuario notó que el color azul del banner en la parte superior de la página de la versión china de docs GitHub hace que el texto del banner sea ilegible.
• El usuario creó una incidencia en el repositorio, que declaraba el problema y sugería una solución (esta es utilizar un color de fondo diferente para el letrero).
• Se produce un debate y, periódicamente, se llega a un consenso sobre qué solución aplicar.
• Entonces, un colaborador puede crear un pull request con la solución.

Escenarios para solicitudes de cambios

• Quiero arreglar un error tipográcifo en un repositorio.
• Quiero hacer cambios en un repositorio.
• Quiero hacer cambios para corregir un error.
• Quiero comentar los cambios que otros sugieren.

Ejemplo de solicitud de incorporación de cambios

En este ejemplo se muestra cómo un usuario de GitHub creó una solicitud de extracción en nuestro repositorio de código abierto de documentación para corregir un error tipográfico.

En la pestaña Conversación de la solicitud de incorporación de cambios, el autor explica por qué ha creado la solicitud de incorporación de cambios.

La pestaña Archivos cambiados de la solicitud de incorporación de cambios muestra la corrección implementada.

• Este contribuyente nota un error tipográfico en el repositorio.
• El usuario crea un pull request con la solución.
• Un mantenedor de repositorio revisa la solicitud de extracción, la comenta y la fusiona.

Escenarios para GitHub Discussions

• Tengo una pregunta que no se relaciona necesariamente con los archivos específicos del repositorio.
• Quiero compartir las noticias con mis colaboradores o con mi equipo.
• Quiero comenzar o participar en una conversación abierta.
• Quiero hacer un anuncio a mi comunidad.

GitHub Discussions ejemplo

Este ejemplo muestra la GitHub Discussions entrada de bienvenida del repositorio de código abierto GitHub Docs, y muestra cómo el equipo quiere colaborar con su comunidad.

El mantenedor de la comunidad inició un debate para recibir a la comunidad y para pedir a los miembros que se presentaran a sí mismos. Esta publicación fomenta un ambiente acogedor para los visitantes y contribuyentes. Esta publicación también aclara que al equipo le complace ayudar con las contribuciones al repositorio.

Usar Copilot para obtener contexto

Si necesita más contexto o claridad sobre un problema o discusión específicos, puede usar GitHub Copilot para ayudar a responder a sus preguntas. Esto permite obtener información de forma rápida, comprender los subprocesos complejos y adaptarse en consecuencia a los objetivos del proyecto, lo que fomenta la colaboración y el uso compartido de los conocimientos dentro de la comunidad.

Para formular una pregunta sobre una propuesta o discusión:

1. Desde cualquier lugar de GitHub, haga clic en el icono situado junto a la barra de búsqueda de la parte superior derecha de la página.

   

2. En el cuadro "Preguntar Copilot", escriba una pregunta e incluya la dirección URL pertinente en el mensaje. Por ejemplo, podría preguntar:

   • Explain https://github.com/monalisa/octokit/issues/1
   • Summarize https://github.com/monalisa/octokit/discussions/4
   • Recommend next steps for https://github.com/monalisa/octokit/issues/2
   • What are the acceptance criteria for ISSUE URL?
   • What are the main points made by PERSON in DISCUSSION URL?

   Si chatea con GitHub Copilot desde un problema o discusión específicos, no es necesario incluir la dirección URL en su pregunta.

3. Opcionalmente, después de enviar una pregunta, puedes hacer clic en en el cuadro de texto para detener la respuesta.

Pasos siguientes

Estos ejemplos le mostraron cómo decidir cuál es la mejor herramienta para sus conversaciones en GitHub. Pero esto es solo el inicio; puedes hacer mucho más para confeccionar estas herramientas de acuerdo con tus necesidades.

Para las propuestas, por ejemplo, puedes etiquetarlas con etiquetas para buscarlas más rápidamente y crear plantillas de propuesta para ayudar a los contribuyentes a abrir propuestas significativas. Para más información, consulta Acerca de los problemas y Acerca de las plantillas de propuestas y solicitudes de extracción.

Para las solicitudes de cambio, puedes crear borradores de estas si los cambios que propones aún están en curso. Los borradores de pull requests no pueden fusionarse hasta que se marquen como listos para ser revisados. Para más información, consulta Acerca de las solicitudes de incorporación de cambios.

Para GitHub Discussions, puedes establecer un código de conducta y fijar discusiones que contengan información importante para tu comunidad. Para más información, consulta Acerca de los debates.

Para obtener información sobre las características de formato avanzadas que te ayudarán a comunicarte, consulta Inicio rápido para escribir en GitHub.