¿Cómo crear un PR para editar un proyecto en GitHub?
Existen muchos tutoriales sobre este tema, pero complican demasiado las cosas al suponer que uno tiene que contribuir con código a un proyecto. Por lo tanto, antes de eso hay que configurar Git .
¿Qué pasa si solo necesitas editar un archivo, tal vez el README del proyecto, para corregir un error tipográfico?
No necesitas saber cómo codificar ni cómo usar Git para hacer eso. Pero una vez que comiences a hacer Pull Requests, ¡podrás hacer muchas más cosas y colaborar en proyectos con otras personas! Y tal vez esto te impulse a contribuir con código más adelante.
Supongo que ya tienes una cuenta de GitHub (gratuita) . Si no la tienes, ve a github.com y obtén una.
Déjame mostrarte el proceso.
Fui a esta página https://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 de la gramática, esto es solo para encontrar un ejemplo
Sé que ese 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.md https://github.com/GoogleChrome/web.dev/blob/master/src/site/content/en/blog/prefers-color-scheme/index.md directamente en GitHub y presiono el ícono del lápiz en la barra de herramientas de archivos. Al pasar el mouse sobre él, aparece el mensaje “Bifurca este proyecto y edita el archivo”.
Esto abre una vista del editor con esta información:
Estás editando un archivo en un proyecto al que no tienes acceso de escritura. Si envías un cambio a este archivo, se escribirá en una nueva rama en tu bifurcación flaviocopes/web.dev, para que puedas enviar una solicitud de incorporación de cambios.
Puedo ir y agregar ese punto, luego en el formulario de abajo 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 incorporación de cambios”. Actualmente, los cambios se han realizado en tu bifurcación del proyecto, lo cual GitHub realizó automáticamente cuando hiciste clic en el ícono del lápiz.
En la parte superior de esta vista puedes ver que estoy a punto de enviar un PR al GoogleChrome/web.devproyecto desde mi formulario flaviocopes/web.dev, desde mi rama patch-2a su masterrama. Korean Beauty
Al presionar el botón “Crear solicitud de extracción” se muestra otro formulario donde 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 la misma solicitud de extracción; por eso puede agregar un resumen.
Este repositorio tiene una plantilla para el texto de la solicitud de incorporación de cambios, para ayudar al equipo a administrarlo. Nuestra solicitud de incorporación de cambios es muy simple, por lo que elimino la plantilla y solo pego el contenido del mensaje de confirmación anterior.
¿Observas la pista de la derecha? Me dicen que el proyecto tiene un archivo CONTRIBUTING.md, que explica cómo contribuir y las pautas. Muy bueno.
Parece que necesitamos firmar un CLA (Contrato de licencia de colaborador) para completar nuestra PR. Ya firmé un CLA de Google en el pasado, por lo que este paso está claro para mí, pero es posible que debas solucionarlo. La mayoría de los proyectos realmente no lo necesitan.
Hice clic en “Crear solicitud de extracción” y ¡la PR ya está enviada!
Ahora depende de los mantenedores del proyecto intervenir y aceptarlo, solo tienes que esperar un correo electrónico que te diga que se ha fusionado, o cualquier comentario que hayan hecho otras personas.
[…pasaron un par de horas…]
Recibí un correo electrónico de respuesta: la solicitud de incorporación de cambios fue rechazada porque ese punto en realidad estaba en el lugar correcto (no lo sabía).
Pero, de todos modos, hay algo que quiero añadir: no te enfades ni te molestes si no aceptan una solicitud de relaciones públicas que envías. Los encargados del mantenimiento 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 opiniones pueden ser muy diferentes y un PR que piensas que es excelente puede no ser bienvenido.
También es mejor preguntar antes de trabajar en una PR importante, para ver si es algo que el proyecto realmente necesita.
Pero este es un tema aparte.
Tal vez te puede interesar:
- Introducción a React
- Agregar evento de clic a los elementos DOM devueltos desde querySelectorAll
- Cómo cambiar el valor de un nodo DOM
- Cómo comprobar si un elemento DOM tiene una clase
Cómo hacer tu primer Pull Request en GitHub
Existen muchos tutoriales sobre este tema, pero complican demasiado las cosas al suponer que uno tiene que contribuir con código a un proyecto. Por lo tanto,
programar
es
https://aprendeprogramando.es/static/images/programar-como-hacer-tu-primer-pull-request-en-github-2037-0.jpg
2025-01-20
Si crees que alguno de los contenidos (texto, imagenes o multimedia) en esta página infringe tus derechos relativos a propiedad intelectual, marcas registradas o cualquier otro de tus derechos, por favor ponte en contacto con nosotros en el mail [email protected] y retiraremos este contenido inmediatamente