Únase a la tendencia de codificación social y contribuya a los repositorios de GitHub

¿Alguna vez encontró un paquete en GitHub que le gustó, pero quería agregar una función rápida, corregir un error que encontró o tal vez simplemente contribuir al código abierto como un todo? Únase a la tendencia de la codificación social, comparta sus habilidades y ayude a beneficiar al mundo del código abierto. En este artículo, aprenda todo sobre cómo contribuir con código a un repositorio en GitHub o cualquier servicio de git alojado.

Obtener configuración

Este artículo asume que ya tiene una cuenta de GitHub, pero si no, por favor, rápidamente Regístrate para una cuenta gratis. Además, asegúrese de tener git instalado ejecutando el siguiente comando en la terminal:

git --version

Si en lugar de ver el número de versión, aparece un mensaje de "comando no encontrado", puede instalar git con el comando:

sudo apt-get -y install git

Bifurcar el repositorio

Primero debe elegir el repositorio al que desea contribuir y visitarlo en su navegador web. Si no está seguro de qué repositorio elegir, puede usar el repositorio de demostración ubicado en

https://github.com/mdizak/muo_demo. Esta es una demostración simple, y puede crear solicitudes de extracción con fines de prueba y aprendizaje.

Mientras visualiza el repositorio en su navegador web, busque el Repositorio de bifurcaciones y haga clic en él. Esto bifurcará el repositorio a su propia cuenta de GitHub y lo llevará a él. A continuación necesitas clonar el repositorio recién bifurcado, así que abre la terminal en tu computadora local y ejecuta:

Cómo clonar un repositorio con GitHub Desktop

¿Quieres familiarizarte con el software en GitHub? A continuación, le mostramos cómo llegar al este con la herramienta GitHub Desktop optimizada.

clon de git https://github.com/myusername/muo_demo.git
cd muo_demo

Naturalmente, asegúrese de cambiar la URL anterior a la de su repositorio recién bifurcado. Una vez clonado, agregue el repositorio original como upstream con el comando:

git remoto agregar aguas arriba https://github.com/mdizak/muo_demo.git

Asegúrese de cambiar la URL en el comando anterior con la del repositorio original que clonó. Esto significa que es un repositorio principal desde el que está trabajando.

Preparar repositorio local

Cada vez que comience a trabajar en una nueva contribución, asegúrese de estar ejecutando la última base de código del repositorio principal. Dentro del directorio del proyecto, ejecute los siguientes comandos en la terminal:

maestro de git checkout
git pull upstream master && git push origin master

El primer comando asegura que está trabajando actualmente en la rama maestra, y el segundo comando sincroniza el repositorio principal con sus repositorios locales y de GitHub. Esto asegura que está modificando el código base más actualizado y no está trabajando con código desactualizado.

También asegúrese de verificar si el proyecto tiene un archivo contrib.md, y si es así, asegúrese de seguir lo que dice. A veces, los proyectos tienen pautas específicas sobre cómo proporcionar contribuciones, que siempre deben seguirse.

Crear una nueva sucursal

Necesita crear una nueva rama que contendrá todas las modificaciones para esta contribución, que luego se fusionará en el repositorio principal de GitHub por los encargados del mantenimiento del proyecto. La rama debe ser alfanumérica y puede tener el nombre que desee.

Aunque no es obligatorio, generalmente se considera una cortesía común anteponer el nombre de la rama con revisión / para corregir errores rápidamente o característica/ para funciones adicionales. Elija el nombre de la rama que desee y ejecute el comando:

git checkout -b feature / my_cool_feature

Siempre debe crear una rama separada para cada característica / corrección de errores, y nunca incluir múltiples contribuciones en una. Esto ayuda a mantener un flujo de desarrollo fluido y también ayuda a garantizar que su contribución sea aceptada e incluida en el proyecto.

Ahora que se ha creado su rama, continúe y complete las modificaciones necesarias que le gustaría con el flujo de trabajo estándar de git.

Confirmar y crear una solicitud de extracción

Una vez que haya completado el trabajo en su contribución, confírmelo con un mensaje de confirmación adecuado y empújelo a su repositorio bifurcado con los comandos:

git commit - archivo commit.txt
git push -u característica de origen / my_cool_feature

El último paso es crear una solicitud de extracción que avise a los encargados del mantenimiento del proyecto que hay una nueva contribución pendiente. Visite el repositorio de GitHub bifurcado en su navegador web y verá un botón desplegable que le permite cambiar de rama. Cambie a su rama recién creada y la siguiente página contendrá un enlace que le permitirá crear una nueva solicitud de extracción.

Al hacer clic en ese enlace, verá una página que muestra su mensaje de confirmación y todos los cambios que ha realizado dentro del código. Revise todo para asegurarse de que sea correcto, agregue cualquier mensaje adicional necesario para los mantenedores y envíe la solicitud de extracción.

Continuar contribuyendo a GitHub

¡Felicitaciones, ha enviado con éxito una contribución a un proyecto de GitHub!

Su solicitud de extracción ahora está pendiente de revisión y aprobación por parte de los encargados del mantenimiento del proyecto, y se le notificará por correo electrónico si fue aprobada o no, y con cualquier mensaje que tengan para usted. Ahora que ha aprendido cómo contribuir a proyectos en GitHub, siga avanzando y ayude a hacer crecer el comunidad de código abierto.

Cómo agregar más RAM a su dispositivo Android con una tarjeta MicroSD

Si su teléfono o tableta Android funciona un poco lento, es posible que solo necesite un poco más de RAM. Podemos ayudar con eso.

Sobre el Autor