README.es.md

Primeras Contribuciones

Es difícil. Siempre es difícil la primera vez que hacés algo. Especialmente cuando estás colaborando, equivocarse no es algo agradable. Pero open source (o código abierto) se trata de colaboración y de trabajar juntos. Queremos simplificár la forma en la que nuevos contribuidores open-source aprenden y contribuyen por primera vez.

Leer artículos y ver tutoriales puede ayudar, pero lo que viene es mejor que hacer las cosas sin estropear nada realmente. Éste proyecto se enfoca en ser una guía y en simplificár la forma en la que los novatos hacen su primera contribución. Recuerda que 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á entretenido.

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

Bifurcá(Fork) éste repositorio

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

Cloná(Clone) el repositorio

Ahora cloná éste 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 ejecutá el siguiente comando de git:

git clone "url que copiaste"

Donde "url que copiaste" (sin las comillas) es la url a éste 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 tú computador

Crear una rama(Branch)

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

cd first-contributions

Ahora creá 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 abrí el archivo Contributors.md en un editor de texto y añadi tu nombre, luego guardá el archivo. Si vas al directorio del proyecto y haces git status, verás que hay cambios. Agregá 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"

cambiá <tu-nombre> con tu nombre

Mandá(Push) tus cambios a GitHub

Haz push de tus cambios usando el comando git push

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

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

Enviar(Submit) tus cambios para ser revisados

Si vas a tú repositorio en GitHub, verás un botón Compare & pull request. Haz click sobre éste botón.

Ahora creá la pull request

Ahora yo estaré fusionando tus cambios (haciendo merge) en la master branch de éste 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, cambiá a la master branch

git checkout master

Luego, agregá la url de mi repo como upstream remote url

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

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

git fetch upstream

Aquí estamos trayendo todos los cambios en mi fork (upstream remote). Ahora, necesitás 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 hacés 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