#fedora-classroom: Taller de Git

Meeting summary

1. 1. http://rpmdev.proyectofedora.org/issues/461#note-2 (V1K1N60, 21:43:57)
   2. Agenda de la sesion (tezcatl, 21:46:14)
   3. Obtener una copia local del repositorio de trabajo (tezcatl, 21:46:59)
   4. Enviar una colaboracion para la Revista al repositorio (tezcatl, 21:47:28)
   5. Revisar y hacer correcciones a articulos en el repositorio (tezcatl, 21:47:51)
   6. Montar articulos en Scribus para la preparacion de la publicacion final (tezcatl, 21:48:32)
   
   
2. Obtener una copia local del repositorio de trabajo (tezcatl, 21:49:18)
   1. https://admin.fedoraproject.org/accounts/group/view/gitrevista-fedora-latam Es el grupo de colaboradores con acceso de escritura al repositorio. (tezcatl, 21:50:23)
   2. Sponsors que pueden aprobar ingreso al grupo son Maria Gracia Leandro (Tatica), Mauricio Moreno (V1K1N60) y su servidor (tezcatl) (tezcatl, 21:51:28)
   3. Los miembros del grupo (como gomix), pueden a�r directamente colaboraciones y editar los archivos (tezcatl, 21:52:32)
   4. IDEA: el objetivo del repositorio es agilizar las contribuciones permitiendo a los colaboradores acceder, revisar y corregir los articulos y el maquetado directamente, sin mediar enviar los archivos por correo electronico y esperar a que sean copiados a otra parte (tezcatl, 21:54:11)
   5. Para conseguir una copia del repositorio de trabajo que tenemos en fedorahosted, usaremos uno de los siguientes comandos: (tezcatl, 21:58:07)
   6. git clone git://git.fedorahosted.org/git/revista-fedora-latam.git (tezcatl, 21:58:22)
   7. Este comando les traera una copia del repositorio, aunque no hayan ingresado aun al grupo de colaboradores en FAS (tezcatl, 21:59:26)
   8. ACTION: Los colaboradores de la revista, que aun no estan en el grupo en FAS, soliciten unirse por favor (tezcatl, 22:00:27)
   9. Para obtener una copia del repositorio, ya configurada para que ustedes envien directamente sus colaboraciones, el comando cambia un poco: (tezcatl, 22:02:44)
   10. git clone ssh://{usuario-FAS}@git.fedorahosted.org/git/revista-fedora-latam.git (tezcatl, 22:03:44)
   11. Noten la diferencia entre las URL's; git:// (suficiente para obtener una copia simple) y ssh:// (especificando su usuario en FAS, para facilitarles la colaboracion) (tezcatl, 22:05:07)
   
   
3. Enviar una colaboracion para la Revista al repositorio (tezcatl, 22:09:49)
   1. Podemos crear nuevos articulos (o esbozos, borradores, drafts, como quieran llamarle) (tezcatl, 22:10:48)
   2. Podemos agregar imagenes y otros dise�para las ilustraciones de la Revista (tezcatl, 22:11:08)
   3. Podemos revisar y hacer correcciones tanto a los articulos individualmente, como al maquetado de la Revista (tezcatl, 22:11:42)
   
   
4. A�r un articulo al repositorio (tezcatl, 22:14:39)
   1. No importa si el articulo esta en etapa de borrador (o lo estamos copiando de otro sitio pero esta pendiente de revision) (tezcatl, 22:15:27)
   2. 1.- Solo guarden el archivo dentro del directorio pool, con formato de texto simple (tezcatl, 22:17:27)
   3. 2.- git add archivo-recien-creado (tezcatl, 22:19:48)
   4. con �git status� podemos observar el cambio que acabamos de hacer (tezcatl, 22:21:33)
   5. 3.- git commit -m 'Comentario descriptivo de los cambios' (tezcatl, 22:26:38)
   6. Esto es equivalente al comentario que tenemos que hacer cuando editamos paginas en el wiki, para ayudar a los que revisan el historial de cambios en el repositorio (tezcatl, 22:27:55)
   7. se recomienda "hacer commit" frecuentemente, para administrar mejor la historia del repositorio y aislar mas facilmente errores y poder deshacerlos sin dolor :) (tezcatl, 22:29:38)
   8. 4.- git push (tezcatl, 22:31:52)
   9. Si el push fue exitoso, veremos algo como: "ff46e29..24e1167 master -> master" (tezcatl, 22:37:41)
   10. https://fedorahosted.org/revista-fedora-latam/browser Pueden ver la estructura del repositorio actual y el ultimo cambio ;) (tezcatl, 22:42:04)
   
   
5. Agregar imagenes al repositorio (tezcatl, 22:42:30)
   1. Para agregar imagenes al repositorio, se siguen los mismos pasos que para a�r articulos. (tezcatl, 22:43:06)
   2. la unica diferencia es que los agregaremos al directorio pool/pics (tezcatl, 22:43:41)
   3. Resumiendo (ejemplo): 1.- git add imagen_cool_para_portada.svg -> 2.- git commit -m 'Envio imagen para portada de numero 6' -> 3. git push (tezcatl, 22:45:58)
   
   
6. Revisar y hacer correcciones a articulos en el repositorio (tezcatl, 22:47:23)
   1. El flujo de trabajo para revisores/correctores, cambia simplemente en que en lugar de a�r un articulo primero al repositorio, vamos a editar primero el articulo en cuestion con nuestro editor favorito (tezcatl, 22:49:11)
   2. ejecutamos git status para verificar que git esta registrando nuestra edicion (tezcatl, 22:52:00)
   3. en caso de que git no este al tanto de que hemos modificado el articulo, ejecutamos git add articuloencuestion.txt (ejemplo) (tezcatl, 22:52:43)
   4. a continuacion hacemos git commit -m 'Revision del articulo ____ (en progreso/listo/etc.)' (tezcatl, 22:53:39)
   5. git push (tezcatl, 22:53:52)
   
   
7. Montar articulos en Scribus para la preparacion de la publicacion final (tezcatl, 22:56:21)
   1. Scribus guarda sus archivos (los .sla) en formato de texto plano, por ello es perfecto para que git registre los cambios. (tezcatl, 22:57:45)
   2. Ejemplo: 1.- git add revista-0006.sla -> 2.- git commit -m 'Comienzo a montar articulos de proxima edicion' -> 3.- git push (tezcatl, 23:01:18)
   3. Ejemplo: 1.- git status (verificamos los cambios que guardamos en Scribus). -> 2.- git commit -m 'Agrego articulo de seccion RPM' -> 3.- git push (tezcatl, 23:02:55)
   4. No olviden siempre vincular las imagenes con las que ilustran el archivo, en el directorio pool/pics del repositorio (tezcatl, 23:06:06)
   5. https://admin.fedoraproject.org/accounts/group/view/gitrevista-fedora-latam No olviden solicitar su ingreso, para facilitar recibir sus contribuciones (tezcatl, 23:08:51)
   6. http://proyectofedora.org/mailman/listinfo/revista_proyectofedora.org Lista de correos de colaboradores en la infra de Latam. (tezcatl, 23:10:42)
   7. https://fedorahosted.org/mailman/listinfo/revista-fedora-latam Lista auxiliar (automaticamente se envian commit a esta lista, ademas). (tezcatl, 23:13:17)

Action items

1. Los colaboradores de la revista, que aun no estan en el grupo en FAS, soliciten unirse por favor

People present (lines said)

1. tezcatl (105)
2. V1K1N60 (5)
3. zodbot (3)