{"id":16391671,"url":"https://github.com/jcrodriguez1989/firstcontributionsinr","last_synced_at":"2025-10-26T14:30:16.025Z","repository":{"id":52064225,"uuid":"295175156","full_name":"jcrodriguez1989/firstContributionsInR","owner":"jcrodriguez1989","description":"🚀✨ Mini tutorial que nos enseña a contribuir al código libre en R ","archived":false,"fork":false,"pushed_at":"2023-11-01T00:45:49.000Z","size":833,"stargazers_count":1,"open_issues_count":4,"forks_count":5,"subscribers_count":3,"default_branch":"master","last_synced_at":"2023-11-01T01:30:10.842Z","etag":null,"topics":["contribution","hacktoberfest","open-source","tutorial"],"latest_commit_sha":null,"homepage":"","language":"R","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jcrodriguez1989.png","metadata":{"files":{"readme":"README.Rmd","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2020-09-13T15:02:23.000Z","updated_at":"2023-11-01T01:30:13.846Z","dependencies_parsed_at":"2023-01-20T17:00:29.477Z","dependency_job_id":"b5932050-2068-43f0-9380-870fac881257","html_url":"https://github.com/jcrodriguez1989/firstContributionsInR","commit_stats":null,"previous_names":[],"tags_count":0,"template":null,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jcrodriguez1989%2FfirstContributionsInR","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jcrodriguez1989%2FfirstContributionsInR/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jcrodriguez1989%2FfirstContributionsInR/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jcrodriguez1989%2FfirstContributionsInR/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jcrodriguez1989","download_url":"https://codeload.github.com/jcrodriguez1989/firstContributionsInR/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":219862848,"owners_count":16555951,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["contribution","hacktoberfest","open-source","tutorial"],"created_at":"2024-10-11T04:46:59.974Z","updated_at":"2025-10-26T14:30:15.533Z","avatar_url":"https://github.com/jcrodriguez1989.png","language":"R","funding_links":[],"categories":[],"sub_categories":[],"readme":"---\noutput: github_document\n---\n\n```{r, include = FALSE}\nknitr::opts_chunk$set(collapse = TRUE, comment = \"#\u003e\", out.width = \"100%\")\nlibrary(\"firstContributionsInR\")\n\n```\n\n# Primeras Contribuciones en R\n\n\u003c!-- badges: start --\u003e\n[![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.png)](https://github.com/ellerbrock/open-source-badges/)\n[![R build status](https://github.com/jcrodriguez1989/firstContributionsInR/workflows/R-CMD-check/badge.svg)](https://github.com/jcrodriguez1989/firstContributionsInR/actions)\n\u003c!-- badges: end --\u003e\n\nMini tutorial que nos enseña a contribuir al código libre en R. Este tutorial se basa en el trabajo \ndel repositorio [First Contributions\n](https://github.com/firstcontributions/first-contributions/blob/master/translations/README.es.md).\n\n## ¡Contribuyentes actuales!\n\nA este repositorio han contribuido `r nrow(obtener_contribuyentes())` personas.\nTomando una muestra de 500, veamos la distribución del país de los contribuyentes:\n\n```{r muestreo}\nlibrary(\"firstContributionsInR\")\nlibrary(\"ggplot2\")\n\nggplot(muestra_contribuyentes(n = 500), aes(x = Pais)) +\n  geom_bar()\n```\n\n## Instalación del paquete R\n\nActualmente, `firstContributionsInR` se encuentra únicamente como un paquete de\nGitHub.\n\nPara instalarlo, corre el siguiente código en una consola R:\n\n```{r eval = FALSE}\n# Si no tenemos instalado el paquete `{remotes}`,\nif (!require(\"remotes\")) {\n  # entonces lo instala.\n  install.packages(\"remotes\")\n}\n# Utilizando el paquete `{remotes}` instala el repositorio \"jcrodriguez1989/firstContributionsInR\"\n# desde github.\nremotes::install_github(\"jcrodriguez1989/firstContributionsInR\")\n```\n\n## ¡Tu primera contribución!\n\nSi no lo has hecho aún, [inicia sesión en GitHub](https://github.com/login). Si no tienes una cuenta, [créala](https://github.com/join), ¡es gratis!\n\nSi no tienes git en tu equipo, puedes encontrar instrucciones para instalarlo en [este enlace](https://help.github.com/articles/set-up-git/). Igualmente, RStudio incluye una interfaz a git `r emojifont::emoji(\"wink\")`.\n\n### Bifurca (*Fork*) este repositorio\n\nHaz un *fork* de este repositorio haciendo click en el botón \"*Fork*\" en la parte superior derecha en esta página.\nEsto creará una copia de este repositorio en tu cuenta de GitHub.\n\n### Clona (*Clone*) el repositorio\n\n\u003cimg style=\"float: right;\" width=\"300\" src=\"README_files/capturas/copy-to-clipboard.png\" alt=\"Copiar URL al portapapeles\" /\u003e\n\nAhora clona este repositorio en tu equipo. Haz click en el botón \"*Code*\" y luego haz click en el icono para *copiar al portapapeles*.\n\nAbre RStudio, haz click en *File* ~\u003e *New Project...* ~\u003e *Version Control* ~\u003e *Git*, pega la \"url que acabas de copiar\" en el campo de *Repository URL:* y dale click a *Create Project*.\n\n\n```{r, echo=FALSE}\nknitr::include_graphics(\"README_files/capturas/rstudio-clone.png\")\n```\n\n### Crea una rama (*Branch*)\n\n\u003cimg style=\"float: right;\" width=\"300\" src=\"README_files/capturas/rstudio-git.png\" alt=\"Panel git de RStudio\" /\u003e\n\nEn 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\".\n\n\u003cimg style=\"float: right;\" width=\"300\" src=\"README_files/capturas/rstudio-branch.png\" alt=\"Nueva rama en RStudio\" /\u003e\n\n### Haz los cambios necesarios y confirma (*Commit*) esos cambios\n\nAbre el archivo `R/zzz.R`, añade tu nombre y bandera. Guarda el archivo.\n\nAgrega los cambios realizados (archivo `R/zzz.R`) tildándolos y dando click en *Commit*.\n\n\u003cimg style=\"float: right;\" width=\"300\" src=\"README_files/capturas/rstudio-add.png\" alt=\"Agregar archivos git\" /\u003e\n\nAgrega un mensaje al *Commit* (por ejemplo, \"Agregando a `\u003ctu-nombre\u003e` como contribuyente\"), y vuelve a clickear en *Commit*. Se abrirá una ventana que muestra los cambios realizados, ciérrala dando click en *Close*.\n\n\u003cimg style=\"float: right;\" src=\"README_files/capturas/rstudio-commit.png\" alt=\"Commitear archivos\" /\u003e\n\n### Manda (*Push*) tus cambios a GitHub\n\nHaz *push* de tus cambios. Para hacer esto, solo basta con dar click en el botón *Push*.\n\n\u003cimg style=\"float: right;\" width=\"300\" src=\"README_files/capturas/rstudio-push.png\" alt=\"Enviar archivos mediante git push\" /\u003e\n\n### Envía (*Submit*) tus cambios para ser revisados\n\nSi vas a tu repositorio en GitHub, verás un botón `Compare \u0026 pull request`. Haz click sobre este botón.\n\n\u003cimg style=\"float: right;\" src=\"README_files/capturas/compare-and-pull.png\" alt=\"crea una pull request\" /\u003e\n\nAhora envía la *pull request*.\n\n\u003cimg style=\"float: right;\" src=\"README_files/capturas/submit-pull-request.png\" alt=\"enviar la pull request\" /\u003e\n\nPronto 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.\n\n### ¿Cuáles son los siguientes pasos?\n\n¡Enhorabuena! ¡Has completado el flujo de trabajo *_fork ~\u003e clone ~\u003e edit ~\u003e PR_* que encontrarás habitualmente como contribuidor!\n\nSi quieres perfeccionar tus habilidades con git, te recomiendo el material [Happy Git and GitHub for the useR\n](https://happygitwithr.com/).\n\n### ¿En qué puedo contribuir?\n\n¡Fácil! Dirígete al repositorio de GitHub de tu paquete R favorito, por ejemplo [el de `ggplot2`](https://github.com/tidyverse/ggplot2). Haz click en el botón [*Issues*](https://github.com/tidyverse/ggplot2/issues). ¡Asígnate uno de los cientos de issues que debe haber sin resolver!\n\n```{r echo = FALSE, results = \"asis\", eval = tolower(months(Sys.Date())) %in% c(\"septiembre\", \"october\")}\ncat(\"\n### Hacktoberfest\n\n¡Oye! Estamos en Octubre, época en la que [Hacktoberfest](https://hacktoberfest.digitalocean.com/) nos premia por contribuir al código libre!\nInscríbete al Hacktoberfest, y durante todo Octubre, si realizas 4 Pull Requests a repositorios adheridos, recibirás un premio por ello!\n\n¿Qué repositorios participan en Hacktoberfest? En el [siguiente enlace](https://github.com/search?l=R\u0026q=label%3Ahacktoberfest+state%3Aopen+no%3Aassignee+is%3Aissue\u0026type=Issues) encontrarás repositorios R para los cuales sus creadores han marcado issues fácilmente solucionables durante el Hacktoberfest.\nAdemás, también valen PR no asociadas a issues, para cualquiera de los repositorios R de [esta lista](https://github.com/topics/hacktoberfest?l=R).\nTambién valen PR a otros repositorios públicos siempre que el PR sea etiquetado como _hacktoberfest-accepted_ por quien mantiene el repositorio.\n\n\")\n```\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjcrodriguez1989%2Ffirstcontributionsinr","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjcrodriguez1989%2Ffirstcontributionsinr","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjcrodriguez1989%2Ffirstcontributionsinr/lists"}