README.ec.md

Primeras Contribuciones

Este proyecto tiene como objetivo simplificar y guiar la forma en que los principiantes hacen su primera contribución. Si está buscando hacer su primera contribución, siga los pasos a continuación.

Si eres un neófit@ con la linea de comandos,

En caso de no tener instalado Git en tu equipo, te dejo una para guia para instalarlo.

Has un "Fork" de este repositorio

Presiona el boton "fork" de este repositorio en la parte superior derecha de la página. Al hacer esto, se crea una copia de este repositorio en tu cuenta de GitHub.

Has un "Clone" del repositorio copiado

Ahora clona el repositorio al que le hiciste un fork previamente, el URL del repositorio deberia estar asi https://github.com/<tu-usuario>/first-contributions. Entra en tu cuenta de Github, y has click en el botón clone or download y luego has clic en el ícono para copy.

Abre tu terminal y ejecuta el siguiente comando:

git clone "la url del repositorio que copiaste"

Donde "la url del repositorio que copiaste" (sin las comillas dobles) es la url a este repositorio se veria algo asi https://github.com/<tu-usuario>/first-contributions.git(tu fork a este proyecto).

Por ejemplo:

git clone https://github.com/<tu-usuario>/first-contributions.git

Donde <tu-usuario> es tu usuario de GitHub. Con este comando estas copiando loslos contenidos del repositorio first-contributions de GitHub a tu equipo.

Crea una rama (Branch)

Cambia al directorio del repositorio en tu equipo (si es que no estás ahí ya).

cd first-contributions

Ahora crea una rama (branch) usando el comando git checkout:

git checkout -b <dale un nombre>

Por ejemplo:

git checkout -b add-julio-jaramillo

Haz los cambios necesarios y has un "Commit" de esos cambios

Abre el archivo Contributors.md en un editor de texto y añade tu nombre. No lo añadas ni al principio ni al final del archivo, hazlo en cualquier otro sitio. Guarda el archivo.

Si vas al directorio del proyecto y ejecutas el comando git status, podrás ver los cambios ya reflejados.

Agrega esos cambios a la rama (branch) que creaste antes usando el comando git add:

git add Contributors.md

Ahora puedes hacer un commit sobre estos cambios ejecutando el comando git commit:

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

reemplazando <nombre> con tu nombre.

Haz un "Push" de tus cambios a GitHub

Mandar un push de tus cambios usando el comando git push:

git push origin <nombre-rama>

Reemplaza <nombre-rama> con el nombre de la rama que creaste anteriormente.

Envía (Submit) tus cambios para ser revisados

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

Ahora envía el pull request.

Pronto estaré combinando tus cambios (haciendo merge) con la rama master de este proyecto. Recibirás una notificación por correo electrónico cuando los cambios hayan sido combinados.

¿Cuáles son los siguientes pasos?

¡Felicidades! ¡Has completado la línea de trabajo fork -> clone -> edit -> PR que encontrarás habitualmente como contribuidor!

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

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

Ahora empieza a contribuir a otros proyectos. Hemos reunido una lista de proyectos con issues sencillas para que puedas empezar. Échale un ojo a la lista de proyectos en la web app.

Material adicional

Tutoriales usando otras herramientas

GitHub Desktop	Visual Studio 2017	GitKraken	Visual Studio Code	Atlassian Sourcetree	IntelliJ IDEA