21:40:46 <tezcatl> #startmeeting Taller de Git
21:40:46 <zodbot> Meeting started Wed Feb  2 21:40:46 2011 UTC.  The chair is tezcatl. Information about MeetBot at http://wiki.debian.org/MeetBot.
21:40:46 <zodbot> Useful Commands: #action #agreed #halp #info #idea #link #topic.
21:41:14 <tezcatl> #meetingname Taller de uso de Git para colaboradores de la Revista Fedora Latam
21:41:14 <zodbot> The meeting name has been set to 'taller_de_uso_de_git_para_colaboradores_de_la_revista_fedora_latam'
21:42:00 <tezcatl> Bienvenido todos compa�s colaboradores de la Revista Fedora Latam
21:42:11 <tezcatl> interesados y lurks tambi�;)
21:43:28 <V1K1N60> !
21:43:38 <tezcatl> Dale V1K1N60
21:43:43 <V1K1N60> solo mencionar los requisitos para la class
21:43:57 <V1K1N60> #link http://rpmdev.proyectofedora.org/issues/461#note-2
21:44:09 <V1K1N60> no tengo peticiones pendientes en el grupo
21:44:10 <V1K1N60> eof
21:44:11 * tezcatl propone que en �a ocasi�nos saltemos formalidades
21:44:22 <tezcatl> Gracias V1K1N60
21:44:50 <tezcatl> Cuando tengan una duda, pregunta, comentario o cualquier cosa que quieran decir, simplemente escr�nlo
21:44:58 <tezcatl> no vamos a pedir la palabra en �a sesi�
21:45:34 <tezcatl> Me comenta gomix que algunos caracteres se ven extranhos en los clientes,
21:45:46 <tezcatl> de modo que voy a tratar de evitar los acentos por esta ocasion
21:46:02 * tezcatl tendra que ver este detalle con los operadores del canal
21:46:14 <tezcatl> #info Agenda de la sesion
21:46:59 <tezcatl> #info Obtener una copia local del repositorio de trabajo
21:47:28 <tezcatl> #info Enviar una colaboracion para la Revista al repositorio
21:47:51 <tezcatl> #info Revisar y hacer correcciones a articulos en el repositorio
21:48:32 <tezcatl> #info Montar articulos en Scribus para la preparacion de la publicacion final
21:49:18 <tezcatl> #topic Obtener una copia local del repositorio de trabajo
21:50:23 <tezcatl> #link https://admin.fedoraproject.org/accounts/group/view/gitrevista-fedora-latam Es el grupo de colaboradores con acceso de escritura al repositorio.
21:51:28 <tezcatl> #info Sponsors que pueden aprobar ingreso al grupo son Maria Gracia Leandro (Tatica), Mauricio Moreno (V1K1N60) y su servidor (tezcatl)
21:52:32 <tezcatl> #info Los miembros del grupo (como gomix), pueden a�r directamente colaboraciones y editar los archivos
21:54:11 <tezcatl> #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
21:54:33 * tezcatl LOL que linea mas larga!!! :D
21:54:46 <tezcatl> �dudas hasta aqui?
21:56:03 <tezcatl> Les recuerdo que en esta sesion no necesitan pedir la palabra, para agilizar resolver dudas, etc.
21:57:21 <tezcatl> Ok, entonces proseguimos.
21:58:07 <tezcatl> #info Para conseguir una copia del repositorio de trabajo que tenemos en fedorahosted, usaremos uno de los siguientes comandos:
21:58:22 <tezcatl> #info git clone git://git.fedorahosted.org/git/revista-fedora-latam.git
21:59:26 <tezcatl> #info Este comando les traera una copia del repositorio, aunque no hayan ingresado aun al grupo de colaboradores en FAS
22:00:27 <tezcatl> #action Los colaboradores de la revista, que aun no estan en el grupo en FAS, soliciten unirse por favor
22:02:44 <tezcatl> #info Para obtener una copia del repositorio, ya configurada para que ustedes envien directamente sus colaboraciones, el comando cambia un poco:
22:03:44 <tezcatl> #info git clone ssh://{usuario-FAS}@git.fedorahosted.org/git/revista-fedora-latam.git
22:05:07 <tezcatl> #info 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)
22:05:58 * tezcatl usa por ejemplo: git clone ssh://tezcatl@git.fedorahosted.org/git/revista-fedora-latam.git
22:06:50 <tezcatl> �dudas hasta aqui?
22:08:54 <tezcatl> No duden en hacer uso de la palabra en cualquier momento, no estamos usando el protocolo ! -> eof ;)
22:09:01 <tezcatl> continuemos
22:09:49 <tezcatl> #topic Enviar una colaboracion para la Revista al repositorio
22:10:21 <tezcatl> Una vez que hemos obtenido una copia del repositorio, podemos comenzar a trabajar en este
22:10:48 <tezcatl> #info Podemos crear nuevos articulos (o esbozos, borradores, drafts, como quieran llamarle)
22:11:08 <tezcatl> #info Podemos agregar imagenes y otros dise�para las ilustraciones de la Revista
22:11:42 <tezcatl> #info Podemos revisar y hacer correcciones tanto a los articulos individualmente, como al maquetado de la Revista
22:13:55 <tezcatl> El flujo de trabajo mas sencillo con el repositorio es el siguiente.
22:14:39 <tezcatl> #topic A�r un articulo al repositorio
22:15:27 <tezcatl> #info No importa si el articulo esta en etapa de borrador (o lo estamos copiando de otro sitio pero esta pendiente de revision)
22:16:23 <tezcatl> Simplemente creamos el archivo dentro del directorio revista-fedora-latam/pool/
22:16:59 <tezcatl> puede ser con gedit, con vi, con emacs, con leafpad, o hasta con {open,libre}office
22:17:27 <tezcatl> #info 1.- Solo guarden el archivo dentro del directorio pool, con formato de texto simple
22:18:14 <tezcatl> Sin embargo hasta este momento, solo esta en el directorio, pero aun no es parte del repositorio (ni local, ni remoto, ni de nadie).
22:18:53 <tezcatl> Para a�rlo al indice de archivos que git toma en cuenta (para sincronizar los repositorios llegado el momento),
22:19:19 <tezcatl> tenemos que decirle a git que a� (add) este archivo que acabamos de crear.
22:19:48 <tezcatl> #info 2.- git add archivo-recien-creado
22:21:33 <tezcatl> #info con �git status� podemos observar el cambio que acabamos de hacer
22:23:13 <tezcatl> Pero aun no esta en el repositorio de los demas...
22:23:52 <tezcatl> Digamos que los cambios (nuevos archivos, eliminar otros ya innecesarios, ediciones)
22:24:17 <tezcatl> son el equivalente a la "previsualizacion" que hacemos en el wiki antes de guardar la pagina
22:25:00 <tezcatl> no exactamente, pero ayuda a entender porque si nosotros ya comenzamos a trabajar en un articulo aun no aparece en el repositorio de los demas
22:25:57 <tezcatl> Para continuar, necesitamos agregar este cambio al indice de contribuciones que git tiene que preparar para enviar al repositorio comun
22:26:38 <tezcatl> #info 3.- git commit -m 'Comentario descriptivo de los cambios'
22:27:55 <tezcatl> #info 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
22:29:38 <tezcatl> #info se recomienda "hacer commit" frecuentemente, para administrar mejor la historia del repositorio y aislar mas facilmente errores y poder deshacerlos sin dolor :)
22:30:55 <tezcatl> **Pero despues de hacer commit, ya tenemos guardados los cambios en nuestro repositorio, pero no aparecera en el de los demas**
22:31:30 <tezcatl> Para enviar al repositorio original (origin) tenemos que empujar los cambios hacia este (hacer push)
22:31:52 <tezcatl> #info 4.- git push
22:37:41 <tezcatl> #info Si el push fue exitoso, veremos algo como:  "ff46e29..24e1167  master -> master"
22:38:20 <tezcatl> simplemente indica el cambio en el repositorio.
22:42:04 <tezcatl> #link https://fedorahosted.org/revista-fedora-latam/browser Pueden ver la estructura del repositorio actual y el ultimo cambio ;)
22:42:30 <tezcatl> #topic Agregar imagenes al repositorio
22:43:06 <tezcatl> #info Para agregar imagenes al repositorio, se siguen los mismos pasos que para a�r articulos.
22:43:41 <tezcatl> #info la unica diferencia es que los agregaremos al directorio pool/pics
22:43:57 <tezcatl> esto es algo totalmente convencional y podria cambiar en otro momento
22:44:30 <tezcatl> por ahora es la estructura que acordamos V1K1N60 y su servidor
22:45:58 <tezcatl> #info Resumiendo (ejemplo): 1.- git add imagen_cool_para_portada.svg -> 2.- git commit -m 'Envio imagen para portada de numero 6' -> 3. git push
22:47:16 <tezcatl> Continuemos entonces con Revisiones/Correcciones
22:47:23 <tezcatl> #topic Revisar y hacer correcciones a articulos en el repositorio
22:49:11 <tezcatl> #info 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
22:49:22 <tezcatl> Se recomienda:
22:50:00 <tezcatl> Una vez hechos los cambios al articulo
22:52:00 <tezcatl> #info ejecutamos git status para verificar que git esta registrando nuestra edicion
22:52:43 <tezcatl> #info en caso de que git no este al tanto de que hemos modificado el articulo, ejecutamos git add articuloencuestion.txt (ejemplo)
22:53:39 <tezcatl> #info a continuacion hacemos git commit -m 'Revision del articulo ____ (en progreso/listo/etc.)'
22:53:46 <tezcatl> y finalmente:
22:53:52 <tezcatl> #info git push
22:55:32 <tezcatl> Se recomienda avisar por la lista de correos, cuando el articulo ya este listo para que los dise�res lo incluyan en el maquetado de la revista.
22:55:59 <tezcatl> Terminemos entonces, con el maquetado en Scribus.
22:56:21 <tezcatl> #topic Montar articulos en Scribus para la preparacion de la publicacion final
22:57:45 <tezcatl> #info Scribus guarda sus archivos (los .sla) en formato de texto plano, por ello es perfecto para que git registre los cambios.
22:58:24 <tezcatl> De este modo, si hay algun error en el maquetado de cierto articulo, otro dise�r puede trabajar en el maquetado
22:58:45 <tezcatl> sin esperar a que se terminen las revisiones de los articulos restantes
22:59:14 <tezcatl> y en caso de que se cometiese algun error, se pueden revertir los cambios (como siempre hemos mencionado).
22:59:51 <tezcatl> La secuencia de cambios que tiene que seguir un dise�r, es practicamente la misma que
23:00:10 <tezcatl> para agregar articulos o imagenes al repositorio:
23:01:18 <tezcatl> #info Ejemplo: 1.- git add revista-0006.sla -> 2.- git commit -m 'Comienzo a montar articulos de proxima edicion' -> 3.- git push
23:01:39 <tezcatl> y para continuar trabajando sobre un maquetado ya creado por otro dise�r
23:02:55 <tezcatl> #info Ejemplo: 1.- git status (verificamos los cambios que guardamos en Scribus). -> 2.- git commit -m 'Agrego articulo de seccion RPM' -> 3.- git push
23:06:06 <tezcatl> #info No olviden siempre vincular las imagenes con las que ilustran el archivo, en el directorio pool/pics del repositorio
23:06:29 <tezcatl> Y... con esto yo termino mi participacion en esta sesion.
23:06:57 <tezcatl> Espero sus comentarios, opiniones, ideas y preguntas.
23:08:51 <tezcatl> #link https://admin.fedoraproject.org/accounts/group/view/gitrevista-fedora-latam No olviden solicitar su ingreso, para facilitar recibir sus contribuciones
23:10:42 <tezcatl> #link http://proyectofedora.org/mailman/listinfo/revista_proyectofedora.org Lista de correos de colaboradores en la infra de Latam.
23:13:17 <tezcatl> #link https://fedorahosted.org/mailman/listinfo/revista-fedora-latam Lista auxiliar (automaticamente se envian commit a esta lista, ademas).
23:13:39 * tezcatl les agradece a todos su interes y participaciones :D
23:13:58 <tezcatl> Nos seguimos leyendo por la lista y en RPMDEV.
23:14:03 <tezcatl> Buenas tardes y noches.
23:14:08 <tezcatl> #endmeeting