Cómo contribuir al código abierto: Introducción a Git

Introducción

Los proyectos de código abierto alojados en repositorios públicos se benefician de las contribuciones de la comunidad de desarrolladores más amplia y normalmente se gestionan a través de Git.

Git, un sistema de control de versiones distribuido, ayuda a individuos y equipos a contribuir y mantener proyectos de software de código abierto. De descarga y uso gratuitos, Git es un ejemplo de proyecto de código abierto.

Este tutorial analiza los beneficios de contribuir a proyectos de código abierto y repasa la instalación y configuración de Git para que puedas contribuir a proyectos de software.

Participación en proyectos de código abierto

El software de código abierto es software que está disponible gratuitamente para su uso, redistribución y modificación.

Los proyectos que siguen el modelo de desarrollo de código abierto fomentan un proceso transparente que avanza mediante la revisión por pares distribuida. Los proyectos de código abierto pueden actualizarse rápidamente según sea necesario, proporcionando un software fiable y flexible que no se basa en sistemas propietarios cerrados.

Participar en proyectos de código abierto ayuda a garantizar su máxima calidad y a representar a la amplia base de usuarios finales de la tecnología. Cuando los usuarios finales contribuyen a proyectos de código abierto mediante código o documentación, sus diversas perspectivas aportan valor añadido al proyecto, a sus usuarios finales y a la comunidad de desarrolladores en general.

La mejor manera de empezar a contribuir a proyectos de código abierto es empezar contribuyendo al software que ya usas. Como usuario de una herramienta en particular, eres quien mejor comprende qué características son más valiosas para el proyecto. Asegúrate de leer primero la documentación del software. De hecho, muchos proyectos de código abierto tienen un archivo CONTRIBUTING.md en el directorio raíz que debes leer detenidamente antes de contribuir. También puedes consultar los foros de la comunidad del proyecto, si están disponibles.

Finalmente, si empiezas contribuyendo al software de código abierto, es buena idea empezar poco a poco: toda contribución es valiosa. Puedes empezar corrigiendo errores tipográficos, añadiendo comentarios o redactando documentación más clara.

Git

Git es uno de los sistemas de control de versiones de software más populares. Fue creado en 2005 por Linus Torvalds, creador del kernel de Linux. Junio Hamano, quien originalmente desarrolló el kernel de Linux, es el actual mantenedor del proyecto.

Muchos proyectos almacenan sus archivos en un repositorio de Git, y sitios como GitHub, GitLab y Bitbucket han facilitado compartir y contribuir con código. Cada directorio de trabajo en Git es un repositorio completo con historial y seguimiento completos, independiente del acceso a la red o de un servidor central.

El control de versiones se ha convertido en una herramienta esencial en el desarrollo de software moderno, ya que estos sistemas permiten realizar un seguimiento del software desde el código fuente. Usted y otros miembros del equipo de desarrollo pueden realizar un seguimiento de los cambios, revertir a pasos anteriores y ramificar desde el código base para crear versiones alternativas de archivos y directorios.

Git es muy útil para proyectos de código abierto porque facilita las contribuciones de varios desarrolladores. Cada colaborador puede ramificar desde la rama principal del repositorio de código base para separar sus cambios y luego enviar una solicitud de incorporación de cambios para integrarlos en el proyecto principal.

Para usar Git para contribuir a proyectos de código abierto, verifiquemos si Git está instalado y, si no, verifiquemos cómo instalarlo en su máquina local.

Comprueba si Git está instalado.

Primero, debes comprobar si tienes las herramientas de línea de comandos de Git instaladas en tu ordenador. Si has creado tus propios repositorios de código, probablemente tengas Git instalado en tu equipo local. Algunos sistemas operativos también vienen con Git instalado, así que conviene comprobarlo antes de instalarlo.

Puedes comprobar si Git está instalado y qué versión estás usando abriendo una ventana de terminal en Linux o Mac o una ventana del símbolo del sistema en Windows y escribiendo el siguiente comando:

git --version

Pero si Git no está instalado, obtendrá un error similar al siguiente:

-bash: git: command not found

'git' is not recognized as an internal or external command, operable program, or batch file.

En ese caso, necesitas instalar Git en tu equipo. Veamos cómo instalarlo en varios sistemas operativos principales.

Instalación de Git en Linux

La forma más sencilla de instalar y configurar Git es usar los repositorios predeterminados de Linux. Veamos cómo instalar Git en tu equipo Linux local con este método.

Instalación de Git en Ubuntu o Debian

Puede usar las herramientas de gestión de paquetes APT para actualizar su lista local de paquetes. Después, puede descargar e instalar la aplicación:

sudo apt update
sudo apt install git

Aunque esta es la forma más rápida de instalar Git, es posible que la versión sea anterior a la más reciente. Si necesitas la versión más reciente, usa esta guía para compilar Git desde el código fuente.

Desde aquí puedes ir a la sección de configuración de la puerta.

Instalación de Git en CentOS

Usaremos yum, el administrador de paquetes nativo de CentOS, para buscar e instalar el último paquete Git disponible en los repositorios de CentOS.

Primero asegurémonos de que yum esté actualizado ejecutando este comando:

sudo yum -y update

La bandera -y se utiliza para alertar al sistema de que estamos al tanto de realizar cambios y evita que la terminal nos solicite confirmación.

Ahora, podemos continuar e instalar Git:

sudo yum install git

Aunque esta es la forma más rápida de instalar Git, es posible que la versión sea anterior a la más reciente. Si necesita la versión más reciente, compile Git desde el código fuente siguiendo la opción 2 de esta guía.

Desde aquí puedes ir a la sección de configuración de la puerta.

Instalación de Git en Fedora

Los paquetes Git para Fedora están disponibles a través de yum y dnf. DNF o Dandified Yum, introducido en Fedora 18, ha sido el gestor de paquetes predeterminado para Fedora desde Fedora 22.

Desde la ventana de su terminal, actualice dnf e instale Git:

sudo dnf update
sudo dnf install git

Si tienes una versión anterior de Fedora, puedes usar el comando yum. Primero, actualizamos yum y luego instalamos Git:

sudo yum update
sudo yum install git

Desde aquí puedes ir a la sección de configuración de la puerta.

Instalación de Git en macOS

En tu Mac local, si escribes el comando Git en la ventana de la terminal (como git --version arriba), se te solicitará que instales Git si aún no está instalado en tu sistema. Cuando recibas este mensaje, debes aceptar la instalación de Git, seguir las instrucciones y responder a las indicaciones en la ventana de la terminal.

Puedes instalar la última versión de Git en tu Mac mediante el instalador binario. Existe un instalador de Git para OS X que se puede descargar desde el sitio web de Git. Al hacer clic aquí, la descarga se iniciará automáticamente.

Una vez que Git esté completamente instalado, puedes ir a la sección de configuración de Git.

Instalación de Git en Windows

Para Windows, la compilación oficial está disponible para descargar desde el sitio web de Git. Al hacer clic aquí, la descarga se iniciará automáticamente.

También existe un proyecto de código abierto llamado Git para Windows, independiente del sitio web oficial de Git. Este proyecto proporciona herramientas de línea de comandos y de interfaz gráfica de usuario para usar Git eficazmente en equipos Windows. Para obtener más información sobre este proyecto y ver y descargar el código, visite el sitio web del proyecto Git para Windows.

Una vez que Git esté completamente instalado, puedes ir a la sección de configuración de Git.

Configuración de Git

Ahora que tienes Git instalado, necesitas hacer algunas cosas para que los mensajes de confirmación que genera contengan la información correcta.

La forma más sencilla de hacerlo es mediante el comando git config. En concreto, necesitamos proporcionar nuestro nombre y correo electrónico, ya que Git integra esta información en cada confirmación que realizamos. Podemos añadir esta información escribiendo:

git config --global user.name "Your Name"
git config --global user.email "[email protected]"

Podemos revisar todos los elementos de configuración que se han establecido escribiendo:

git config --list

user.name=Your Name
[email protected]

Como puedes ver, este formato es un poco diferente. La información se almacena en tu archivo de configuración de Git, que puedes editar opcionalmente con un editor de texto, como nano:

nano ~/.gitconfig

[user]
name = Your Name
email = [email protected]

Cuando haya terminado de editar su archivo, puede salir de nano escribiendo las teclas control y x y presionando y cuando se le solicite para guardar el archivo.

Hay muchas opciones que puedes configurar, pero estas dos son esenciales para evitar futuras advertencias.

Resultado

Con Git instalado y configurado en su máquina local, ahora está listo para usar Git para controlar las versiones de sus proyectos de software, así como para contribuir a proyectos de código abierto que son gratuitos para el público.

Agregar sus propias contribuciones al software de código abierto es una excelente manera de interactuar más con la comunidad de desarrolladores más amplia y ayuda a garantizar que el software creado para el público sea de alta calidad y totalmente representativo de los usuarios finales.