HAZ tu primera contribución Open Source — Transcript

Full transcript

1. 0:00Una buena manera de aumentar nuestras oportunidades laborales es
2. 0:03creando proyectos personales y subiéndolos a nuestra cuenta de GitHub,
3. 0:07esto sirve como portafolio para que los reclutadores conozcan más acerca de nuestro perfil
4. 0:12y entonces puedan conocer más acerca de los proyectos en los que
5. 0:15hemos trabajado o lo que somos capaces de hacer,
6. 0:19otra manera de conseguir una mayor visibilidad es también contribuyendo a proyectos Open Source,
7. 0:25en este vídeo vamos a ver de manera específica cómo hacer nuestra primera contribución
8. 0:29a un proyecto Open Source.
9. 0:32Para esto vamos a venir a este repositorio llamado first-contributions,
10. 0:37cuyo objetivo es ayudar a quienes recién empezamos
11. 0:40a realizar nuestra primera contribución a proyectos Open Source,
12. 0:45y aquí en la descripción de este repositorio encontramos los pasos que vamos a seguir,
13. 0:50lo primero que haremos es un fork de este repositorio,
14. 0:54hacer un fork significa crear una copia de este repositorio pero asociado a nuestra cuenta,
15. 1:01a nuestra cuenta de GitHub.
16. 1:02¿Sí?
17. 1:03El segundo paso, es clonar el repositorio que está asociado a nuestra cuenta
18. 1:08y una vez que lo tenemos clonado en nuestra computadora, vamos a crear una rama,
19. 1:12sobre esta rama vamos a aplicar un cambio
20. 1:14que finalmente vamos a subir este cambio a nuestro repositorio
21. 1:19para que como último paso podamos enviar un Pull Request
22. 1:24hacia el repositorio del autor original,
23. 1:27para que pueda revisar nuestro cambio y aprobarlo,
24. 1:31¿sí?
25. 1:33este es el workflow típico y clásico que se sigue al realizar contribuciones hacia proyectos Open Source,
26. 1:40hacemos fork de un repositorio, lo clonamos localmente,
27. 1:43editamos lo que creemos correspondiente y enviamos un Pull Request,
28. 1:48o sea una solicitud para que el autor del repositorio original haga pull de nuestros cambios
29. 1:54hacia el repositorio principal,
30. 1:57¿sí? entonces esto es lo que vamos a estar haciendo
31. 2:01y vamos a hacer esto desde la línea de comandos, desde la terminal
32. 2:04existen herramientas con interfaces gráficas de usuario que permiten hacer lo mismo,
33. 2:08pero lo recomendable es usar siempre la consola,
34. 2:14como ya mencionamos, el primer paso es hacer fork del repositorio,
35. 2:18en el caso de GitHub simplemente hacemos clic en este botón
36. 2:22aquí, ustedes pueden hacer fork del repositorio hacia su cuenta de GitHub personal
37. 2:27o pueden hacer fork hacia una organización,
38. 2:30en GitHub es posible crear organizaciones en donde varios integrantes pueden pertenecer a ella,
39. 2:36por ejemplo esta organización es una que había creado cuando estaba en la universidad con unos compañeros,
40. 2:42en realidad no llegamos a publicar a muchos repositorios aquí, pero quedó de recuerdo se puede decir,
41. 2:48entonces yo voy a hacer fork hacia mi cuenta personal de GitHub,
42. 2:53esto va a llevar unos segundos nos dice,
43. 2:58y ahora estamos aquí, ya no estamos en firstcontributions/first-contributions
44. 3:05sino que estamos en JCarlosR que es mi usuario de GitHub / first-contributions, ¿sí?
45. 3:12en GitHub siempre los repositorios tienen esta estructura, esta ruta de enlace,
46. 3:16tienen nuestro username y tienen el nombre del repositorio
47. 3:20y aquí nos dice forked from firstcontributions/first-contributions
48. 3:27si hacemos una traducción literal forked from significa que este proyecto es una bifurcación de este otro,
49. 3:34¿sí?
50. 3:35es como una versión alternativa que nace a partir de esta otra
51. 3:39esto es necesario porque nosotros no tenemos acceso a este repositorio,
52. 3:43entonces lo que hacemos es crear una bifurcación un forked,
53. 3:46crear nuevos commits en nuestro repositorio propio y luego hacer un Pull Request,
54. 3:50o sea hacemos una solicitud para que el autor de este repositorio acepte el cambio o no,
55. 3:56¿sí?
56. 3:57ya tenemos listo el primer paso,
57. 4:00este número indica cuántos forks se han realizado
58. 4:04y en este caso las estrellas están en cero porque estoy en el repositorio
59. 4:08asociado a mi cuenta y no en el repositorio original en donde si podemos ver que tiene muchas más estrellas,
60. 4:16esto es solamente como un indicador que nos permite agregar este repositorio como uno de nuestros favoritos
61. 4:22por ejemplo le voy a dar clic
62. 4:24y aumenta el contador.
63. 4:27Bien,
64. 4:28el segundo paso luego de hacer un fork, es clonar este repositorio,
65. 4:35no desde aquí sino desde acá, entonces vamos a clonar,
66. 4:40clonar significa que vamos a descargar el proyecto en nuestra computadora para poder hacer cambios,
67. 4:44crear commits y subirlos a GitHub nuevamente,
68. 4:47podemos clonar en donde creamos correspondiente, en este caso yo voy a clonar dentro de esta carpeta,
69. 4:54por lo tanto aquí pondré git clone, seguido de la URL del repositorio asociado a mi cuenta de GitHub,
70. 5:06aquí debemos esperar un momento y el tiempo que vaya a tardar depende de nuestra conexión de internet
71. 5:12y de la cantidad de archivos que forman parte de un repositorio determinado,
72. 5:18una vez que terminamos de clonar podemos usar el comando cd para ubicarnos
73. 5:22en la carpeta first-contributions,
74. 5:27estando aquí nosotros podemos modificar un archivo desde la consola, pero si tenemos un editor
75. 5:34podemos hacerlo también desde un editor de texto,
76. 5:37por ejemplo ahora voy a abrir el proyecto desde Sublime Text, presiono Control + o
77. 5:47y en este caso vamos a abrir Contributors.md
78. 5:52la extensión md significa que estamos tratando con un archivo de markdown
79. 5:57¿sí?
80. 5:58que es un formato especial que nos permite escribir texto plano y finalmente generar html,
81. 6:05por ejemplo este numeral significa que esto es un título
82. 6:09y probablemente luego se reemplase por un h1,
83. 6:12estos guiones representan que queremos tener aquí una lista desordenada un <ul>
84. 6:17y estos corchetes, con estos paréntesis y estos enlaces
85. 6:21generan un hipervínculo cuando ya se muestra esto en una página,
86. 6:27¿sí?
87. 6:27entonces, quien creó este repositorio tuvo una muy buena idea porque
88. 6:33nos permite hacer fork, nos permite clonar el repositorio y nos sugiere ahora
89. 6:38agregar nuestro nombre en algún lugar, nos dice no agreguen su nombre al inicio
90. 6:42tampoco lo hagan al final, pueden hacerlo por el medio es lo que nos dice,
91. 6:47¿sí?, entonces en el lugar que ustedes crean apropiado pueden agregar su nombre,
92. 6:52yo por ejemplo quiero agregar mi nombre aquí, debajo de este nombre que no tiene enlace,
93. 6:56pero antes de hacerlo, lo recomendable es crear una rama,
94. 7:01¿sí? una rama representa un cambio como sugerencia que quiero hacer a un proyecto que no es mío.
95. 7:08¿Sí? ¿Cómo creamos una rama?
96. 7:11Simplemente usamos el comando git checkout -b
97. 7:15b de branch
98. 7:16y ponemos luego el nombre de la rama que queremos crear,
99. 7:21entonces aquí voy a poner git checkout -b
100. 7:25y el nombre de la rama puede ser cualquiera,
101. 7:27en este caso voy a ponerle add jcarlosr
102. 7:34¿sí?
103. 7:35es simplemente una sugerencia que nos da el autor del repositorio
104. 7:40pero podría tener un nombre distinto,
105. 7:43aquí se acaba de crear la rama add-jcarlosr
106. 7:48y también se hizo switch a esa rama,
107. 7:51para confirmar esto, nosotros podemos usar el comando git branch
108. 7:56y ver de esta manera las ramas que tenemos,
109. 7:58el asterisco aparecerá al costado de la rama en la que estamos ubicados actualmente,
110. 8:04como ya estamos en esta rama nueva, vamos ahora a hacer un cambio
111. 8:08y a crear un commit para que ese comit forme parte de esta rama,
112. 8:13entonces, aquí vamos a copiar una línea, vamos a poner el nombre que queremos que aparezca,
113. 8:20puede ser nuestro nombre personal o puede ser el username de nuestra cuenta de GitHub,
114. 8:26¿sí? entonces copiamos esto y agregamos por aquí un enlace hacia nuestra cuenta de GitHub.
115. 8:34En la consola nosotros podemos hacer git status para ver qué cambios tenemos,
116. 8:39nos dice que contributors.md ha sido modificado
117. 8:43podemos hacer git add . esto selecciona automáticamente todos los cambios,
118. 8:46o podemos ser más específicos
119. 8:50y seleccionar solamente el archivo que hemos modificado.
120. 8:56Hay algunos casos en que nos conviene ser específicos
121. 8:59porque a veces navegando entre archivos de un proyecto
122. 9:03terminamos cambiando otros archivos que en realidad no queríamos cambiarlo,
123. 9:07pero si somos específicos, no vamos a subir cambios que no queremos subir,
124. 9:12¿sí? porque la idea es que un Pull Request
125. 9:15haga un cambio específico y no cambios innecesarios, por ejemplo añadir un espacio,
126. 9:21añadir un Tab en distintos archivos que no tienen relación entre ellos,
127. 9:26como ya seleccioné los archivos con los que quiero formar un commit
128. 9:29ahora vamos a crear un commit y le vamos a dar un nombre,
129. 9:34aquí la sugerencia que nos da el autor del repositorio es que usemos este nombre,
130. 9:38Add <nuestro nombre> to Contributors list
131. 9:43entonces vamos a poner Add JCarlosR hacia la lista de Contributors ,
132. 9:50¿sí?
133. 9:51y luego vamos a hacer push para subir los cambios a nuestro repositorio que tenemos en GitHub,
134. 9:57para ello hacemos git push origin
135. 10:00seguido del nombre de nuestra rama,
136. 10:02es muy común ver este comando que es cuando trabajamos directamente sobre la rama master
137. 10:07pero en nuestro caso, como estamos trabajando en una rama por separado, que justamente podemos ver aquí,
138. 10:14tenemos que usar este comando de acá
139. 10:16¿sí? vamos a hacer push de los cambios que están en esta rama sobre el repositorio origin.
140. 10:22¿Cuál es el repositorio origin?
141. 10:29Para subir los cambios he tenido que ingresar mi username, mi contraseña
142. 10:34y así mismo, un código de verificación,
143. 10:38ya que mi cuenta está protegida por un mecanismo conocido como 2 Factor Authentication;
144. 10:43es decir, cuando voy a iniciar sesión hay un código que se genera y que llega a mi dispositivo móvil
145. 10:49para poder verificar que soy yo realmente quien está usando mis credenciales,
146. 10:55y bien, acabamos de subir nuestro commit a GitHub.
147. 10:57Anteriormente les decía ¿qué es origin?
148. 11:00Origin es el repositorio al cual estamos subiendo nuestros cambios,
149. 11:04es el repositorio al cual estamos subiendo nuestro commit
150. 11:08podemos usar git remote -v
151. 11:11para ver a qué repositorio remoto estamos conectados,
152. 11:14en este caso estamos conectados a este repositorio perteneciente a esta cuenta,
153. 11:19entonces, origin es el alias para hacer referencia a este repositorio remoto,
154. 11:25mientras que ésta viene a ser la rama local sobre la cual hemos trabajado,
155. 11:29tras subir cambios, de hecho aquí ha aparecido
156. 11:33un mensaje, una notificación en tiempo real que nos dice que se ha creado esta rama
157. 11:38hace menos de un minuto,
158. 11:40¿sí?
159. 11:41entonces lo siguiente es hacer clic en este botón,
160. 11:46Compare & pull request,
161. 11:48comprar y solicitar que el autor haga pull de nuestros cambios en el repositorio original,
162. 11:57al llegar a este punto, aquí tenemos la descripción del commit que hemos ingresado
163. 12:02y aquí podríamos agregar más detalles de qué cambio estamos haciendo.
164. 12:07Cuando hagamos una contribución modificando la lógica de algún algoritmo en algún proyecto,
165. 12:12por ejemplo aquí podríamos comentar qué beneficios aportan los cambios que estamos haciendo
166. 12:17o qué errores son corregidos,
167. 12:20¿sí?
168. 12:21en este caso nos dice que estamos abriendo un Pull Request desde nuestra rama
169. 12:27que está en nuestro repositorio hacia la rama master de este repositorio de aquí,
170. 12:32entonces presionamos Create pull request
171. 12:41y luego de hacer ello, aquí vemos como automáticamente se hace merge
172. 12:45de nuestros cambios sobre el repositorio principal,
173. 12:50normalmente esto debería llevar tiempo para que el autor revise nuestros cambios,
174. 12:55en este caso es automático,
175. 12:57aquí de hecho vemos un comentario, ¿sí? esto de aquí está automatizado
176. 13:02y fue posible gracias a que nuestra rama no tuvo ningún conflicto con la rama base.
177. 13:09Aquí nos dice que nuestro Pool Request se llevó a cabo correctamente,
178. 13:13como todo fue muy bien,
179. 13:15nos dice que si queremos podemos borrar a esta rama
180. 13:18o incluso podemos borrar nuestro fork,
181. 13:21el fork completo que hicimos de el repositorio original
182. 13:25y aquí GitHub nos da la opción de eliminar una rama y eliminar el fork,
183. 13:31¿sí?
184. 13:32no es necesario que hagamos ello,
185. 13:34podemos dejarlo allí para que quede como constancia de nuestra contribución.
186. 13:41Bueno, espero que todos los que estén viendo este vídeo
187. 13:44puedan hacer su primera contribución a un proyecto Open Source,
188. 13:47en este caso no hemos aportado hacia una biblioteca o un framework,
189. 13:52pero ya sabemos los pasos que se siguen para hacer una contribución,
190. 13:56entonces, lo siguiente sería que cuando nos encontremos con una biblioteca
191. 14:01que no satisface todos nuestros requerimientos,
192. 14:05en ese caso podemos hacer un fork, clonar la biblioteca,
193. 14:08agregar y mejorar lo que creamos correspondiente y finalmente hacer un Pull Request,
194. 14:13¿sí?
195. 14:15Muchas gracias por ver el vídeo hasta el final,
196. 14:17si tienen alguna duda o sugerencia pueden dejar aquí debajo un comentario.