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

¿Cómo se crea un PR para editar un proyecto 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.

The article I want to edit

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

The github folder of the article

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".

The index.md file

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.

The editor view

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

Propose file change

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

Compare view

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.

Open pull request

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.

Contributing

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!

Pull Request sent

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: