Uso de RStudio y Github con Proyectos de colaboración

Autor

Pedro L. Luque

Fecha de Publicación

12 septiembre 2022

Introducción

En este documento se explica cómo crear un proyecto en RStudio clonando un repositorio en Github.

Se va a usar el repositorio: https://github.com/calote/TDecisionCodigo.

  1. Asegurarse de que Git está instalado en su ordenador. Consulte la siguiente url “Cómo usar Git/GitHub con R” para instalarlo en su sistema operativo.

  2. Se recomienda crear un cuenta gratuita en Github. Visite la página https://github.com/ y seleccione “Sign up”. Para ayuda adicional visite el enlace del punto 1.

Creación de una “Incidencia” (“Issues” o “Comunicar un Problema”)

Para crear un “Issues” (comunicar un problema o incidencia) sobre un repositorio Github para describir alguna errata o indicar alguna mejora, debemos hacer lo siguiente:

  1. En primer lugar debemos de visitar la página del repositorio y hacer login en Github.

  2. Después de introducir nuestras credenciales en Github se podrá crear un “Issues” en cualquier repositorio. Los pasos se muestran en las siguientes capturas:




    Se crearía la incidencia o “issue”. En estas capturas no se ve el resultado de esta “incidencia”, y sí se muestran las incidencias existentes, las cuales se clasifican en “Abiertas o Open” (todavía están sin resolver por los autores del repositorio) y “Cerradas o Closed” (sí han sido resueltas). Es un lugar del repositorio recomendado para visitar por si se tienen problemas y ya han sido resueltos o están por resolver.



Creación de un Fork (duplicar un repositorio en nuestra cuenta)

  1. Creación de un Fork de otro repositorio. Inicialmente el objetivo de hacer un Fork puede ser únicamente tener una copia de otro repositorio en nuestra cuenta de Github para poder aprender. Pero también se puede modificar el código en nuestro repositorio y luego enviárselo al autor del repositorio original a través de un “Pull Request” (PR).

Paso 1: creación un Fork de otro repositorio en Github

Paso 2: creación un Fork de otro repositorio en Github
  1. El repositorio que hemos clonado: https://github.com/luquecalvo/TDecisionCodigo (tiene otra url), podemos clonarlo en nuestro ordenador de forma local con ayuda de RStudio. Podremos realizar cambios sobre el código y hacer “git-commit” (confirmaciones) de los cambios, y finalmente hacer un “Push” (subirlo a nuestro repositorio en Github).

  2. Ahora desde Github se puede hacer un “Pull Requests”:

Crear un “Pull Requests” desde Github

Creación de un proyecto RStudio a partir de un repositorio Github

  1. Abrir RStudio y crear un nuevo proyecto (Git debe estar instalado en nuestro ordenador).

Paso 1: creación Proyecto RStudio clonando un repositorio Github “Version Control”

Paso 2: creación Proyecto RStudio clonando un repositorio Github usando “Git”

Paso 3: creación Proyecto RStudio clonando un repositorio Github se descargan en nuestro ordenador todos los ficheros del repositorio seleccionado.

Proceso de realización de un Pull Request o PR (propuesta de cambios)

Como usuario del repositorio secundario que ha hecho Fork (“luquecalvo”)

Paso 1: Se han hecho modificaciones (en fichero: README.md) en el repositorio de un usuario (“luquecalvo”) que ha hecho un “Fork” del repositorio principal: “calote/TDecisionCodigo”, con la intención de hacer una solicitud de modificación en dicho proyecto (“pull request”)

Paso 2: Para hacer un “pull request (PR)”, estando como usuario que ha hecho un “Fork”: (1) se pulsa en el menú: “Pull requests”, (2) y a continuación sobre el botón “New pull request”

Paso 3: Después de pulsar sobre el botón “New pull request” aparece un informe que nos indica cuales serían los ficheros-modificaciones que se mezclarían (“merge”) con el proyecto principal. Se observa que este informe nos ha llevado al repositorio principal “calote/TDecisionCodigo” aunque seguimos en Github como el usuario “luquecalvo”. A continuación se pulsaría sobre el botón: “Create pull request” (como luquecalvo)

Paso 4: Al pulsar sobre el botón “Create pull request” (como luquecalvo) nos aparece una ventana para introducir un título (1) más una descripción (2) que acompañe nuestro PR al pulsar sobre el botón (3) “Create pull request”

Paso 5: Se muestra sobre el repositorio principal como ha quedado la operación PR que se acaba de realizar. Aparece como PR abierto (“Open”)

Paso 6: Al acceder al repositorio público “calote/TDecisionCodigo” y visitar el apartado “Pull requests” puede observarse que hay uno abierto actualmente y se muestra el título que le hemos puesto al PR creado. (1) Si se pulsa sobre el título podrá consultarse el informe del PR realizado

Proceso de aceptación de los cambios de un Pull Request o PR

Como usuario del repositorio principal (“calote”)

Se hace login en Github como usuario “calote” (propietario del repositorio principal).

Paso 7: Como usuario propietario del repositorio principal se puede revisar un “pull request” y después de revisar lo que aporta, (1) aceptarlo y mezclarlo al pulsar el botón “Merge pull request”

Paso 8: Se ha dejado la opción por defecto “Create a merge commit” al pulsar sobre el botón: “Merge pull request”, pero como puede observarse existen otras 2 opciones adicionales

Paso 9: Se tendría que pulsar (1) finalmente sobre el botón “Confirm merge” para incorporarlo en nuestro proyecto

Paso 10: Nos informa de que el PR ha sido mezclado (“Merged”)

Paso 11: Si se visita ahora el repositorio principal puede observarse que los cambios han sido incorporados (los cambios en el fichero README.md ahora sí están sobre el repositori principal). (1) Si se pulsa sobre el menú “7 commits” podrá consultarse el PR que acabamos de mezclar con nuestro proyecto

Paso 12: Se muestra los últimos commits (confirmaciones) que se han realizado sobre el repositorio principal. En cualquier momento puede verse cómo estaba el proyecto en un momento pasado (historia) al pulsar (1) sobre el botón “<>”

Paso 13: Después de pulsar en el botón “<>” (volver a un momento anterior del proyecto) se puede observar el contenido del fichero README.md antes de realizar el PR

Paso 14: Una forma de volver al momento actual del proyecto sería pulsando sobre el botón (1) de la imagen y luego seleccionando en “Ramas” (Branches) elegir la “Rama master” (2)

Paso 15: Puede observarse que después de seleccionar el botón “Rama master” se vuelve al proyecto en el momento actual. También se podría haber seleccionado este punto de la historia del proyecto seleccionando en “Commits” el último realizado “<>”

Otras referencias interesantes

  • En esta url puede encontrar instrucciones para instalar Git en el sistema operativo de su ordenador.
  • En esta url puede encontrar un tutorial sobre: “Cómo hacer tu primer Pull Request (PR)” en Github.
  • En esta url puede encontrar un tutorial sobre: “Qué es un fork en Git y cómo hacer un Fork en Github”.
  • En esta url puede encontrar información útil sobre Git y Github.

Utilidades: Cómo crear un nuevo repositorio en Github

En las siguientes capturas puede verse los pasos a seguir para crear un nuevo repositorio en Github:

Paso 1: creación un nuevo repositorio en Github.

Paso 2: creación un nuevo repositorio en Github.

Utilidades: Cómo añadir un colaborador a un repositorio nuestro en Github

Paso 1: Seleccionar: Settings > Manage access > Invite a collaborator > username.