Uy, la cosa está complicada. La primera vez que uno le mete la ficha a algo nuevo es re difícil, ¿sí o qué? Más cuando toca camellar con otra gente, porque nadie quiere meter las patas y quedar como un guevón. Nosotros queremos es que los pipiolos que le quieren entrar al código abierto la tengan más suave para aprender y aportar su granito de arena.
Bacano leer artículos y ver tutoriales y toda esa vaina, pero nada como aprender haciendo, ¿o no? Este proyecto es una guía re chévere para que los novatos le cojan el tiro a esto de contribuir por primera vez. Si quieres estrenar tus pinitos en esto, sigue estos pasos al pie de la letra:
Si no le has cogido el tiro a la consola,acá tenés tutoriales con herramientas más amigables (GUI)
Si no tenés git en tu aparato, podés encontrar cómo instalarlo eneste link.
Dale click al botón de "Fork" allá arriba a la derecha de esta página. Eso te va a crear una copia de este repositorio en tu cuenta, facilito.
Ahora toca clonar este repositorio en tu compu. Andate a tu cuenta de GitHub, dale al botón de "clone or download" y después al iconito para copiar al portapapeles.
Abre tu consola o terminal y ejecuta el siguiente comando de git:
git clone "url que acabas de copiar"
Donde dice "url que acabas de copiar" (sin las comillas, ojo) es la url de este repositorio (tu fork del proyecto). Mira los pasos de antes para sacar la url.
Por ejemplo:
git clone https://github.com/este-eres-tu/first-contributions.git
Cambiá este-eres-tu por tu usuario de GitHub. Acá estás copiando todo el contenido del repositorio first-contributions de GitHub a tu compu.
Metete al directorio del repositorio en tu compu (si no estás ya ahí).
cd first-contributions
Ahora crea una rama (branch) usando el comando git checkout:
git checkout -b <añade tu nombre>
Por ejemplo:
git checkout -b add-alonzo-church
(No es obligatorio que el nombre de la rama tenga la palabra add, pero tiene sentido ponerla porque la idea de esta rama es agregar tu nombre a la lista.)
Abrí el archivo Contributors.md en un editor de texto y agregá tu nombre. No lo pongas ni al principio ni al final del archivo, metelo en cualquier otro lado. Guardá el archivo.
Si vas al directorio del proyecto y ejecutas el comando git status, verás que hay cambios.
Agrega esos cambios a la rama (branch) que creaste anteriormente usando el comando git add:
git add Contributors.md
Ahora hacele un commit a esos cambios ejecutando el comando git commit:
git commit -m "Add <tu-nombre> to Contributors list"
cambiando <tu-nombre> por tu nombre, obviamente.
Mandale un push de tus cambios usando el comando git push:
git push origin <añade-el-nombre-de-la-rama>
Reemplaza <añade-el-nombre-de-la-rama> con el nombre de la rama que creaste antes.
Si vas a tu repositorio en GitHub, verás un botón Compare & pull request. Dale click sobre este botón.
Ahora mandá la pull request.
Dentro de poco voy a estar fusionando tus cambios (haciendo merge) con la rama master de este proyecto. Te va a llegar un correo cuando los cambios estén fusionados.
¡Felicitaciones parcero! ¡Le diste la vuelta completa al proceso fork -> clone -> edit -> PR que vas a usar un montón como contribuidor!
Celebrá tu aporte y compartilo con tus amigos y seguidores en la.web app.
También te podés unir a nuestro equipo de Slack si necesitás una mano o tenés alguna pregunta.Unite a nuestro Slack.
Ahora dale, empezá a contribuir a otros proyectos. Armamos una lista de proyectos con issues fáciles para que arranques. Dale una mirada a lalista de proyectos en la aplicación web.
 |
 |
 |
 |
 |
 |
|---|---|---|---|---|---|
| GitHub Desktop | Visual Studio 2017 | GitKraken | Visual Studio Code | Atlassian Sourcetree | IntelliJ IDEA |