Ú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, regístrese rápidamente para obtener una cuenta gratuita . 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 botón Fork Repository y haga clic en él. Esto bifurcará el repositorio a su propia cuenta de GitHub y lo llevará a él. A continuación, debe clonar el repositorio recién bifurcado , así que abra el terminal en su computadora local y ejecute:

 git clone 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 remote add upstream 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 empiece 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:

 git checkout master
 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 local y 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 hotfix / para correcciones rápidas de errores o función / 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 su rama ha sido creada, 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, consúltelo con un mensaje de confirmación adecuado y envíelo a su repositorio bifurcado con los comandos:

 git commit --file commit.txt
 git push -u origin feature/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 se aprobó 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 la comunidad de código abierto .