20f605468a
* Added spanish translation for GitKraken tutorial * Moving translations to a new branch * Added spanish translation for GitKraken tutorial
7.0 KiB
Primeras Contribuciones
 |
GitKraken Edition |
|---|
Es difícil. Siempre es difícil cuando se hace algo por primera vez. Especialmente cuando se colabora, cometer errores no es algo agradable. Pero el código abierto trata sobre la colaboración y el trabajo en conjunto. Queríamos simplificar la manera en que los contribuyentes de código abierto aprenden y contribuyen por primera vez.
Leer artículos y ver tutoriales puede ayudar, pero ¿qué es mejor que hacer las cosas sin estropear nada?. Este proyecto tiene como objetivo proporcionar orientación y simplificar la manera en que los novatos hacen su primera contribución. Recuerda que cuando más relajado estés, mejor aprenderás. Si buscas hacer tu primera contribución sólo sigue los simples pasos a continuación. Te lo prometemos, será divertido.
Git Kraken
Descarga GitKraken, Instálalo y ábrelo.
Deberías ver el diálogo modal "Welcome to GitKraken" - Regístrate con Github y permite el acceso a Gitkraken a tu cuenta de GitHub.
(opcional) Dirígete a File -> Preferences y configura el directorio de tu proyecto en la raíz de tus repositorios locales.
Bifurca (Fork) este repositorio
Bifurca este repositorio clickeando en el botón fork en la parte superior derecha de esta página.
Esto creará una copia de este repositorio en su cuenta.
Clona el repositorio
En GitKraken, ve a File -> Clone Repo.
Selecciona GitHub.com en el panel derecho. Bajo tu nombre de usuario, deberías ver first-contributions. Haz click en ese repositorio y verifica la ruta completa mostrada al final del panel.
Una vez estés satisfecho con la ruta, clickea "Clone the repo!".
Crear una rama (branch)
Clickea el botón branch de la barra de herramientas.
Nombra tu rama "add-your-name", por ejemplo: "add-william-sutton"
Haz los cambios necesarios y confirma (Commit) esos cambios
Ahora abre el archivo Contributors.md en un editor de texto y agrégale tu nombre, luego guarda el archivo.
Si tienes el repositorio abierto en GitKraken deberías ver que hay cambios. Revisa y prepara esos cambios seleccionando la confirmación (commit) más reciente marcada con "// WIP" y el número de archivos cambiados y el tipo de cambio.
Revisa los archivos que han sido cambiados y decide cuáles deseas preparar para confirmar (stage). La preparación es importante para decirle a git exactamente que archivos deseas asociar con esta confirmación (commit).
Una vez tengas un buen mensaje de confirmación (commit) ("Add to Contributors list" suena agradable y descriptivo) y estés feliz con tus cambios, puedes clickear "Stage all changes" para preparar todo lo modificado o "Stage File" para preparar un archivo individual.
Si cambias de idea, puedes olvidar (unstage) esos cambios, o puedes descartárlos todos. ADVERTENCIA: Como lo implica la palabra descartar, esta es una operación destructiva. Hazlo solo si no quieres ningún cambio(s) desde cualquier repositorio en el que te encuentres.
Clickea en commit.
Felicidades, has confirmado (committed) todos los cambios a la copia local de la rama de tu bifurcación (fork) de first-contributions.¡Adelante!.
Sube (push) los cambios a GitHub
Haz click en el botón Push en la barra de herramientas.
Envía los cambios en la rama origen si quieres que los cambios se reflejen en la rama maestra directamente, sino selecciona la rama apropiada a la cual quieres hacer el push.
Envía tus cambios para revisión
Si vas a tu repositorio en github, verás el botón Compare & pull request. Haz click en él.
Ahora confirma el pull request.
Pronto estaré fusionando todos sus cambios en la rama master de este proyecto. Recibirás una notificación por correo electrónico cuando los cambios hayan sido fusionados.
¿Cuáles son los siguientes pasos?
¡Enhorabuena! ¡Has completado el flujo de trabajo fork -> clone -> edit -> PR que encontrarás habitualmente como contribuidor!
Celebra tu contribución y compártela con tus amigos y seguidores yendo a App web.
También podrías unirte a nuestro equipo de Slack en caso de que necesites ayuda o tengas alguna pregunta. Únete a nuestro equipo de Slack.