Skip to content

Guía básica para contribuir con git

numeroteca edited this page Jun 20, 2017 · 3 revisions

#Si no tienes permiso de escritura en el repositorio

Haz un fork del respositorio en tu-usuario

  1. Sitúate en https://github.com/numeroteca/contratosmenores/
  2. Haz click en "fork" en el menú de arriba a la derecha.
  3. Ahora podŕas ver tu repositorio "forkeado" en https://github.com/**tusuario**/contratosmenores/

Clona tu reposiotorio en local

  1. En línea de comandos escribe git clone https://github.com/tuusuario/contratosmenores.git Esto creará un repositorio en local (tu ordenador) igual que el que está online.

Alternativamente, si quieres que el directorio que contiene se llame de otra forma diferente a contratosmenores debes escribir este comando: git clone https://github.com/tuusuario/contratosmenores.git contratosmenores-nombre-alternativo

Haz tus cambios

  1. Edita con un procesador algún archivo, por ejemplo el archivo data/data_val2015.tsv

  2. Edita y comitea tus cambios. Para ello tienes que hacer dos pasos:

  3. Añade los cambios al stage: git add data/data_val2015.tsv Si tuvieras que añader múltiples archivos: git add data/data_val2015.tsv data/data_paracuellos2014.tsv

También podrías ejecutar el comando add varias veces: git add data/data_val2015.tsv git add data/data_paracuellos2014.tsv ...

Si quieres añadir todos los archivos modificados haz: git add .

  1. Comitea (publica) los cambios añadidos y explica en qué consiste el cambio: git comit -m "Corrige fechas equivocadas de enero" Esta acción agrupa el conjunto de cambios que han sido añadidos en el paso anterior y crea un nuevo estado del repositorio en la rama (branch) master.

Haz públicos tus cambios

Ahora tus cambios están publicados en tu git en local pero todavía no los has subido a github.com.

  1. Sube los cambios al repositorio en github git push Como has clonado el proyecto desde github, e repositorio por defecto será el de github que has cloneado, esto es, tu fork.
  2. Comprueba que lo cambios se han subido en https://github.com/tuusuario/contratosmenores

Pide un pull request

Ahora que tus cambios están online tienes que pedir un Pull request, esto es, decirle al propietario del repositorio original que has hecho cambios y que quieres publicarlos en su repositorio.

  1. Navega hasta https://github.com/**tuusuario**/contratosmenores/pulls y haz click en New pull request. Eso te llevará a https://github.com/numeroteca/contratosmenores/compare/master...tuusuario:master que es donde podrás comparar en qué se diferencian las dos versioens del repositorio y publicar un mensaje informando qué cambios has hecho.

  2. Ahora el/los propietarios del repositorio podrán ver tu pull request en https://github.com/numeroteca/contratosmenores/pulls y aprobarlo o denegarlo.

¡Gracias por colaborar!

#Si tienes permiso de escritura en el repositorio

Por completar.