CONTRIBUTING.md

Como contribuir al Diplomado en Ciencia de Datos 2019

1. Descarga el repositorio

• Instala Git para cualquier SO: Installing Git
• Descarga o clona en tu directorio de trabajo el repositorio; puedes consultar esta guía rápida y fácil. Esto crea en tu directorio de trabajo local una copia del repositorio. La idea es que ahora cada colaborador debe crear una rama de trabajo con su propio Módulo del diplomado. Como ejemplo, el repositorio podría verse de la siguiente forma:

origin
├── Modulo1 ->NewBranch de Javier
│   ├── M1_Python
│   │   ├── MiCodigo.ipynb
│   │   ├── MisDocs
│   ├── M1_Evaluacion
│   │   ├── MiCodigo.ipynb
│   │   └── MisInstrucciones.pdf
├── Modulo2 ->NewBranch de Dan
│   ├── M2_Introduccion
│   │   ├── MiCodigo.ipynb
│   │   └── MisFiguras

             

│   │   
├── Modulo5 ->NewBranch de Jorge
│   ├── M5_Evaluacion
│   │   ├── MiCodigo.ipynb
│   │   └── MisInstrucciones.pdf
│   └── 
├── otros_archivos
└── CONTRIBUTING.md

2. Conocer el proceso de trabajo (Work Flow) de Git (ver por ejemplo esta guía):

• actualizar su repositorio local con git pull origin master,
• crear una rama de trabajo con git checkout -b MyNewBranch
• realizar los cambios en su rama y prepararlos con git add,
• confirmar tus cambios localmente con git commit -m "descripción de tu confirmación", y
• subir los cambios (incluida su nueva rama) en GitHub con git push origin MyNewBranch
• Vaya al repositorio principal en GitHub donde ahora debería ver su nueva rama
• haga clic en el nombre de su rama
• haga clic en el botón "Pull Request"
• haga clic en "Send Pull Request"

3. Conocer la terminología de Git:

REPOS AND BRANCHES

Term	Description
Origin (repo)	Your remote repo (on Github); it is the “origin” for your local copy. Either it is a repo you created yourself or it is a fork of someone else’s GitHub repo.
Upstream (repo)	The main repo (on GitHub) from which you forked your GiHub repo.
Local (repo)	The repo on your local computer.
Master	The main branch (version) of your repo.

BASIC COMMANDS/ACTIONS

Term	Explanation
Fork	Make a copy of someone else’s GitHub repo in your own GitHub account.
Clone	Make a copy of the your GitHub repo on your local computer. In CLI (Computer Local Interface): ‘git clone’ copies a remote repo to create a local repo with a remote called origin automatically set up.
Pull	You incorporate changes into your repo.
Add	Adding snapshots of your changes to the “Staging” area.
Commit	Takes the files as they are in your staging area and stores a snap shot of your files (changes) permanently in your Git directory.
Push	You “push” your files (changes) to the remote repo.
Merge	Incorporate changes into the branch you are on.
Pull Request	Term used in collaboration. You “issue a pull request” to the owner of the upstream repo asking them to pull your changes into their repo (accept your work).