README.es.md

Primeras Contribuciones

Es difícil. Siempre resulta difícil cuando se comienza a hacer algo por primera vez. Principalmente cuando colaboras con otros, pues cometer errores no es nada agradable. Sin embargo el código abierto tiene que ver con la colaboración y el trabajo conjunto. Nuestro objetivo es simplificar la forma en la que los nuevos contribuidores del "open source" aprenden y contribuyen por primera vez.

Leer artículos y ver tutoriales puede ayudar, pero qué mejor es hacer las cosas sin romper nada. Este proyecto se enfoca en ser una guía y en simplificar la forma en la que los novatos hacen su primera contribución. Recuerda: mientras más relajado estés, aprenderás mejor. Si quieres hacer tu primera contribución sólo sigue los sencillos pasos que se muestran a continuación. Te lo prometemos, será divertido.

Si no tienes git en tu máquina, instálalo

Bifurca(Fork) este repositorio

Haz fork de este repo haciendo click en el botón "Fork" que está arriba de esta página. Esto creará una copia de este repositorio en tu cuenta.

Clona(Clone) el repositorio

Ahora clona este repo en tu equipo. Haz click en el botón "Clone" y luego haz click en el ícono para copiar al portapapeles(clipboard)

Abre tu consola o terminal y ejecuta el siguiente comando de git:

git clone "url que copiaste"

Donde "url que copiaste" (sin las comillas) es la url a este repositorio. Mire los pasos previos para obtener la url.

Por ejemplo:

git clone https://github.com/éste-eres-tu/first-contributions.git

Donde "éste-eres-tu" es tu usuario de GitHub. Aquí estás copiando los contenidos del repositorio first-contributions en GitHub a tu computador

Crear una rama(Branch)

Cambia al directorio del repositorio en tu computador si es que no estás ahí.

cd first-contributions

Ahora crea una branch usando git checkout command

git checkout -b <añade tu nombre>

Por ejemplo

git checkout -b add-alonzo-church

Hacer los cambios necesarios y confirmar(Commit) esos cambios

Ahora abre el archivo Contributors.md en un editor de texto y añade tu nombre, luego guarda el archivo. Si vas al directorio del proyecto y haces git status, verás que hay cambios. Agrega esos cambios usando el comando git add que está abajo.

git add Contributors.md

Ahora puedes hacer commit sobre los cambios con el comando git commit

git commit -m "Add <tu-nombre> to Contributors list"

cambia <tu-nombre> con tu nombre

Manda(Push) tus cambios a GitHub

Haz push de tus cambios usando el comando git push

git push origin <añade-tu-nombre>

Cambia <añade-tu-nombre> con el nombre de la branch que creaste antes

Enviar(Submit) tus cambios para ser revisados

Si vas a tu repositorio en GitHub, verás un botón Compare & pull request. Haz click sobre este botón.

Ahora crea la pull request

Ahora yo estaré fusionando tus cambios (haciendo merge) en la master branch de este proyecto. Recibirás una notificación por correo cuando los cambios hayan sido fusionados.

La master branch de tu fork no tendrá esos cambios. Para mantener tu fork sincronizado con el mío, sigue los siguientes pasos.

Manteniendo tu fork sincronizado con éste repositorio

Primero, cambia a la master branch

git checkout master

Luego, agrega la url de mi repo como upstream remote url

git remote add upstream https://github.com/Roshanjossey/first-contributions

Esta es una forma de decirle a git que otra versión de este proyecto existe en la url especificada y que la llamaremos upstream. Una vez que los cambios sean agregados (cuando hice merge), recupera la nueva versión de mi repositorio.

git fetch upstream

Aquí estamos trayendo todos los cambios en mi fork (upstream remote). Ahora, necesitas agregar la nueva revisión de mi repositorio en tu master branch (harás merge)

git rebase upstream/master

Aquí estarás aplicando todos los cambios que recuperaste a la master branch. Si haces push de la master branch ahora, tu fork también tendrá los cambios

git push origin master

Notarás aquí que estás empujando(push) a la url remota llamada origin.

Tutoriales con otras herramientas

GitHub Desktop	Visual Studio 2017	GitKraken

A dónde ir desde aquí?

También podrías unirte a nuestro equipo Slack en caso de que necesites alguna ayuda o tengas alguna pregunta. Únete a nuestro Slack

Aquí hay algunas issues para principiantes en repositorios populares que podrías resolver. Anímate y ve a esos repos para aprender más

exercism	Fun Retros	react	habitat	scikit-learn	Leiningen	numpy	elasticsearch
homebrew	Rust	vuejs	Suave	OpenRA	PowerShell	coala	moment
ava	freeCodeCamp	webpack	hoodie	pouchdb	neovim	babel	brackets
Node.js	Semantic-UI-React