Primeras Contribuciones en R

Mini tutorial que nos enseña a contribuir al código libre en R. Este tutorial se basa en el trabajo del repositorio First Contributions.

¡Contribuyentes actuales!

A este repositorio han contribuido 4 personas. Tomando una muestra de 500, veamos la distribución del país de los contribuyentes:

library("firstContributionsInR")
library("ggplot2")

ggplot(muestra_contribuyentes(n = 500), aes(x = Pais)) +
  geom_bar()

Instalación del paquete R

Actualmente, firstContributionsInR se encuentra únicamente como un paquete de GitHub.

Para instalarlo, corre el siguiente código en una consola R:

# Si no tenemos instalado el paquete `{remotes}`,
if (!require("remotes")) {
  # entonces lo instala.
  install.packages("remotes")
}
# Utilizando el paquete `{remotes}` instala el repositorio "jcrodriguez1989/firstContributionsInR"
# desde github.
remotes::install_github("jcrodriguez1989/firstContributionsInR")

¡Tu primera contribución!

Si no lo has hecho aún, inicia sesión en GitHub. Si no tienes una cuenta, créala, ¡es gratis!

Si no tienes git en tu equipo, puedes encontrar instrucciones para instalarlo en este enlace. Igualmente, RStudio incluye una interfaz a git 😉.

Bifurca (Fork) este repositorio

Haz un fork de este repositorio haciendo click en el botón “Fork” en la parte superior derecha en esta página. Esto creará una copia de este repositorio en tu cuenta de GitHub.

Clona (Clone) el repositorio

Ahora clona este repositorio en tu equipo. Haz click en el botón “Code” y luego haz click en el icono para copiar al portapapeles.

Abre RStudio, haz click en File ~> New Project… ~> Version Control ~> Git, pega la “url que acabas de copiar” en el campo de Repository URL: y dale click a Create Project.

Crea una rama (Branch)

En RStudio, localiza la pestaña Git, hazle click. Da click en el botón New Branch. Dale un nombre a la nueva rama, por ejemplo, “agregar-juana-perez”.

Haz los cambios necesarios y confirma (Commit) esos cambios

Abre el archivo R/zzz.R, añade tu nombre y bandera. Guarda el archivo.

Agrega los cambios realizados (archivo R/zzz.R) tildándolos y dando click en Commit.

Agrega un mensaje al Commit (por ejemplo, “Agregando a <tu-nombre> como contribuyente”), y vuelve a clickear en Commit. Se abrirá una ventana que muestra los cambios realizados, ciérrala dando click en Close.

Manda (Push) tus cambios a GitHub

Haz push de tus cambios. Para hacer esto, solo basta con dar click en el botón Push.

Envía (Submit) tus cambios para ser revisados

Si vas a tu repositorio en GitHub, verás un botón Compare & pull request. Haz click sobre este botón.

Ahora envía la pull request.

Pronto quien mantiene el repositorio (en este ejemplo yo!) estará incorporando tus cambios (haciendo merge) con la rama master de este proyecto. Recibirás una notificación por correo electrónico cuando los cambios hayan sido fusionados.

¿Cuáles son los siguientes pasos?

¡Enhorabuena! ¡Has completado el flujo de trabajo fork ~> clone ~> edit ~> PR que encontrarás habitualmente como contribuidor!

Si quieres perfeccionar tus habilidades con git, te recomiendo el material Happy Git and GitHub for the useR.

¿En qué puedo contribuir?

¡Fácil! Dirígete al repositorio de GitHub de tu paquete R favorito, por ejemplo el de ggplot2. Haz click en el botón Issues. ¡Asígnate uno de los cientos de issues que debe haber sin resolver!