Cómo hacer su primera solicitud de extracción en GitHub

Existen muchos tutoriales sobre este tema, pero complican demasiado las cosas al asumir que uno tiene que contribuircódigoa un proyecto. Entonces esta todo elgitconfiguración antes de eso.

¿Qué pasa si solo necesita editar un archivo, tal vez el proyecto README para corregir un error tipográfico?

No necesita saber cómo codificar o cómo usar Git para hacer eso. Pero una vez que empiece a hacer Pull Requests, podrá hacer muchas más cosas y colaborar en proyectos con otras personas. Y tal vez esto lo empuje a contribuir también con código más adelante.

Supongo que ya tienes un (gratis)GitHubcuenta. Si no lo hace, vaya agithub.comy consigue uno.

Déjame mostrarte el proceso.

Fui a esta paginahttps://web.dev/prefers-color-scheme/y encontré un posible error tipográfico. A esta línea le falta un punto al final.

No soy un nazi gramatical, esto es solo por encontrar un ejemplo 😄

Sé que el sitio está alojado en GitHub, y ese artículo exacto está alojado aquí:https://github.com/GoogleChrome/web.dev/tree/master/src/site/content/en/blog/prefers-color-scheme

Abro el archivo index.mdhttps://github.com/GoogleChrome/web.dev/blob/master/src/site/content/en/blog/prefers-color-scheme/index.mddirectamente en GitHub y presiono el ícono de lápiz en la barra de herramientas del archivo. Al pasar el mouse, dice "Bifurca este proyecto y edita el archivo".

Esto abre una vista de editor con esta información:

Estás editando un archivo en un proyecto al que no tienes acceso de escritura. Enviar un cambio a este archivo lo escribirá en una nueva rama en su fork flaviocopes / web.dev, para que pueda enviar una solicitud de extracción.

Puedo ir y agregar ese punto, luego en el formulario en la parte inferior explico los cambios que hice:

Presioné el botón "Proponer cambio de archivo" y apareció una vista de comparación.

Allí puedo revisar los cambios que hice, para asegurarme de que todo está bien, y finalmente puedo hacer clic en el botón "Crear solicitud de extracción". Actualmente se han realizado cambios entu tenedordel proyecto, que fue creado automáticamente por GitHub al hacer clic en el ícono de lápiz.

En la parte superior de esta vista, puede ver que estoy a punto de enviar un RP alGoogleChrome/web.devproyecto desde mi formularioflaviocopes/web.dev, de mi ramapatch-2a sumasterrama.

Al presionar el botón "Crear solicitud de extracción" se muestra otro formulario en el que puedo escribir una descripción detallada de la solicitud de extracción.

Las solicitudes de extracción pueden contener muchos cambios diferentes, por lo que, en teoría, podría tener muchos archivos editados en el mismo PR, por eso puede agregar un resumen.

Este repositorio tiene una plantilla para el texto de relaciones públicas, para ayudar al equipo a administrarlo. Nuestro PR es muy simple, así que elimino la plantilla y simplemente pego el contenido del mensaje de confirmación anterior.

¿Notas la pista a la derecha? Me dicen que el proyecto tiene un archivo CONTRIBUTING.md, que explica cómo contribuir y las pautas. Muy genial.

Parece que necesitamos firmar un CLA (Acuerdo de licencia de colaborador) para completar nuestro PR. Ya firmé un CLA de Google en el pasado, por lo que este paso está claro para mí, pero es posible que deba solucionarlo. La mayoría de los proyectos realmente no lo necesitan.

¡Hice clic en "Crear solicitud de extracción" y ahora se envía el PR!

Ahora depende de los encargados del mantenimiento del proyecto intervenir y aceptarlo, solo tiene que esperar un correo electrónico que le diga que se ha fusionado o cualquier comentario que hayan tenido otras personas.

[… Pasaron un par de horas…]

Recibí un correo electrónico de vuelta, ¡el PR fue rechazado porque ese punto estaba en el lugar correcto! (No lo sabía).

Pero de todos modos, aquí hay una cosa que quería agregar: no se enoje o se enoje si un PR que envía no es aceptado. Los encargados del proyecto trabajan en él durante meses o años y saben mejor que tú qué es lo mejor para él.

Además, especialmente con el código, las vistas pueden ser muy, muy diferentes y un PR que usted crea que es bueno podría no ser bienvenido.

También es mejor preguntar antes de trabajar en un PR sustancial, para ver si es algo que el proyecto realmente necesita.

Pero este es un tema en sí mismo.

Más tutoriales de git:

• Una hoja de trucos de Git
• Flujo de trabajo de Git para gestionar el trabajo en varias ramas
• Una forma sencilla de gestionar los subrepositorios de Git
• Una lista incompleta de excelentes tutoriales de Git
• Introducción de un desarrollador a GitHub
• La guía completa de Git
• Cómo descubrir un error usando git bisect
• Cómo hacer su primera solicitud de extracción en GitHub
• Cómo actualizar una rama de Git desde otra rama
• Publiqué mi contraseña / clave API en GitHub
• Aplastando las confirmaciones de Git
• Cómo quitar un control remoto de Git