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

Crea 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

Haz los cambios necesarios y confirma (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

Envía (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.

¿A dónde ir desde aquí?

Celebra tu contribución y compártela con tus amigos y seguidores yendo a web app.

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

Ahora empieza a contribuir a otros proyectos. Hemos reunido una lista de proyectos con issues para que puedas empezar. Compruébalas en lista de proyectos en la web app.

Material adicional

Tutoriales con otras herramientas

GitHub Desktop	Visual Studio 2017	GitKraken

Auto promoción

Si te gustó este proyecto, marcalo como favorito con una estrella en GitHub. Si te sientes muy agradecido, sigue a Roshan en Twitter y GitHub.