Skip to content

Latest commit

 

History

History
145 lines (83 loc) · 6.65 KB

File metadata and controls

145 lines (83 loc) · 6.65 KB

Primera contribución

RStudio RStudio Edition

Este repositorio es una versión cortada, recortada y personalizada para RStudio del increíble repositorio primeras contribuciones (y no está afiliado oficialmente con RStudio). Consulte el repositorio original para obtener instrucciones sobre el uso de otras herramientas y traducciones de idiomas.


Introducción

Es dificil. Siempre es difícil cuando haces algo por primera vez. Especialmente cuando estás colaborando, cometer errores no es algo cómodo. Pero el código abierto tiene que ver con la colaboración y el trabajo conjunto. Queríamos simplificar la forma en que los nuevos colaboradores de código abierto aprenden y contribuyen por primera vez.

Leer artículos y ver tutoriales puede ayudar, pero ¿qué es mejor que hacer las cosas sin estropear nada? Este proyecto tiene como objetivo proporcionar orientación y simplificar la forma en que los novatos hacen su primera contribución. Recuerde que cuanto más relajado esté, mejor aprenderá. Si está buscando hacer su primera contribución, simplemente siga los sencillos pasos a continuación. Te lo prometemos, será divertido.


Lo que esto te enseñará

  • Cómo bifurcar un repositorio
  • Cómo hacer una rama
  • Cómo enviar una solicitud de extracción al repositorio original

Lo que esto no te enseñará

  • Cómo construir paquetes R
  • Etiqueta de código abierto

Supuestos

He hecho una serie de suposiciones al escribir esta guía:

  • Tienes una cuenta de GitHub
  • Tiene RStudio instalado.
  • Tiene git instalado y su identidad configurada. Si puede enviar a GitHub, ya lo ha hecho :)
  • Te sientes cómodo usando git con RStudio. Si desea mejorar su conocimiento, le recomiendo trabajar primero con 'Happy Git y GitHub para el usuario'.

¡Bien, empecemos!


Bifurcar este repositorio

Bifurque este repositorio haciendo clic en el botón de bifurcación en la parte superior de esta página.

fork this repository


Esto creará una copia de este repositorio en su cuenta y será redirigido a esta versión del repositorio.

Ahora necesita obtener la URL de su repositorio. Haga clic en "Clonar o descargar" y copie la URL en el cuadro.

clone the repo



Crea un nuevo proyecto

En RStudio, vaya a Archivo -> Nuevo proyecto

Seleccione "Control de versiones" y luego "Git".

En el cuadro de diálogo Nuevo proyecto, pega la URL que copiaste de GitHub en el cuadro "URL del repositorio".

Elija el nombre que desea que se llame al directorio de su computadora y colóquelo en el cuadro "Nombre del directorio del proyecto". De forma predeterminada, este es el nombre del repositorio.

Finalmente, elija dónde desea que se almacene el repositorio clonado haciendo clic en el botón "Examinar".

Una vez que haya terminado, haga clic en "Crear proyecto" para clonar el repositorio y configurar el proyecto.

Git


El repositorio ahora se clonará en la carpeta que especificó.


Crea una sucursal

En la pestaña "Git" del panel superior derecho, haz clic en el botón "nueva rama".

Git tab


Create a new branch


Nombre su rama "agregue-su-nombre", por ejemplo: "agregar-nombre-mariposa"

name your branch


Asegúrese de que "Sincronizar rama con remoto" esté marcado y haga clic en "Crear". Es posible que se le solicite que ingrese su nombre de usuario y contraseña de GitHub.


Realice los cambios necesarios y confirme esos cambios

Ahora abra el archivo Contributors.md en RStudio y agregue su nombre, luego guarde el archivo.

Verá que el archivo tiene una 'M' al lado. Marque la casilla junto a él y luego haga clic en "Confirmar".

commit button


Verá un archivo de diferencias que muestra los cambios que ha realizado en el archivo. Agregue un mensaje de confirmación, un resumen de los cambios que ha realizado, y luego haga clic en "Confirmar". Aparecerá un cuadro para confirmar la confirmación; haga clic en "cerrar".

commit dialog



Enviar cambios a GitHub

Felicitaciones, ha comprometido todos los cambios en su copia local de su rama de su bifurcación de primeras contribuciones. Ahora haga clic en "Push" para sincronizar su confirmación con el repositorio remoto.

push button


Verá un cuadro como este si sus cambios se han realizado correctamente. Haga clic en "Cerrar".

git output log



Envíe sus cambios para su revisión

Si va a su repositorio en github, verá un botón "Comparar y solicitar extracción". Haga clic en ese botón.

create a pull request


Asegúrese de comparar bifurcaciones. A la izquierda debería estar la rama maestra del repositorio original, y a la derecha debería estar la nueva rama que ha creado en su repositorio. Una vez que haya seleccionado las opciones correctas y haya escrito un resumen rápido de los cambios realizados, envíe la solicitud de extracción haciendo clic en "Crear solicitud de extracción".

submit pull request


Pronto fusionaré todos sus cambios en la rama principal de este proyecto. ¡Recibirá un correo electrónico de notificación una vez que se hayan combinado los cambios!

¡Felicitaciones! ¡Acaba de completar la bifurcación estándar -> clonar -> editar -> flujo de trabajo de relaciones públicas que encontrará a menudo como colaborador!