[gentoo-doc-es] Gestión de responsables y tareas

[gentoo-doc-es] Gestión de responsables y tareas

[Jose Luis Rivero (YosWinK)]

Hola a todos:

Tras la reciente aprobación de la normativa del grupo[1], ha llegado el 
momento de comenzar a ponerla en práctica. Lo único que necesitamos es 
elegir el mecanismo mediante el cual registraremos qué documento está 
asignado a cada responsable y que tareas sobre documentos libres se 
están llevando a cabo actualmente.

Hay un par de posibilidades para esto:

1. Utilizar trads.rb

Trads.rb es un script (en ruby) que se encarga de generar una lista, con 
información muy completa sobre el estado de la documentación. Podeis 
verlo en la página del grupo francés [2] o polaco [3].

Puntos fuertes:

a) Muy potente

Puntos débiles:

a) Necesita una máquina host con el repositorio gentoo, solamente 
disponible para desarrolladores.

b) Se basa en el concepto de revisión cvs, en lugar de versión xml como 
tiene overview, teniendo que notificarse manualmente (por medio del 
desarrollador) cada vez que se realiza algún commit al cvs, para 
reflejar que el documento está actualizado.

2. Lista de responsables sobre overview

Actualmente trabajamos con overview.xml [4], me parece la manera más 
sencilla de comprobar el estado de la documentación. Si a esto le 
añadimos una columna más con el responsable, creo que tenemos todo lo 
que nos hace falta. Algo así como lo que tienen los italianos [5], pero 
más completo.

He implementado un feo hack[6] en python, que hace esto mismo: descarga 
el overview.xml actual y le añade una columna de responsable, colocando 
en cada documento el responsable que le corresponde que lee de un fichero.

Puntos fuertes:

a) Muy automático: actualiza el overview via cron dos veces cada día, no 
es necesario que ningún desarrollador marque nada cuando se hace un 
commit, el propio overview reflejará la actualización.

b) Todos los desarrolladores (chiguire, anpereir y yo, actualmente) 
pueden ejecutar el script (ya que está en nuestra máquina 
dev.gentoo.org) y, lo que es más importante, modificar el archivo de 
responsables, salvando de esta manera un posible cuello de botella en 
caso de que uno no esté disponible.

Puntos débiles:

a) Es un feo feo hack sobre el html del overview que seguramente nunca 
debió escribirse, pero se aceptan soluciones mejores con el mismo 
resultado ;)

b) Inconsistente frente a cambios (serios) en el overview.

El script lleva funcionando dos semanas, sin errores. Además, como 
medidad de detección de errores, comprueba si algún 
documento/responsable en el fichero de responsables no fue asignado y,de 
ser así, envía un correo notificandolo (sucede cuando se elimina un 
documento del overview o si hubiera algún cambio en el propio html).

A parte de esto, para las tareas que se realizan sobre documentos 
libres, seguiremos empleando gentoo.es[7] como hasta el momento. Lo 
único que no será necesario que los responsables notifiquen allí nada 
cuando trabajen sobre sus docs.

Yo personalmente prefiero evitar todo el trabajo manual, por parte de 
una sola persona que conlleva trads.rb. Quizá pueda estar equivocado, 
pero sería crear un cuello de botella o una dependencia de alguien excesiva.

Ideas, flames, dudas ... ?

Un saludo.

[1] http://dev.gentoo.org/~yoswink/doc/es/
[2] http://dev.gentoo.org/~neysx/
[3] http://dev.gentoo.org/~rane/trads.xml
[4] http://www.gentoo.org/doc/es/overview.xml
[5] http://dev.gentoo.org/~so/
[6] http://dev.gentoo.org/~yoswink/tmp/gen-doc-es/over-extended.html
[7] http://www.gentoo-es.org/project/issues/125

-- 
Jose Luis Rivero [yoswink@gentoo.org]
Gentoo/Doc Gentoo/Alpha
-- 
gentoo-doc-es@gentoo.org mailing list

Re: [gentoo-doc-es] Gestión de responsables y tareas

[Jordi Molina]

Duda:
como indicamos en los documentos quien es el responsable?

Supongo que es un tag xml, pero seria bueno saberlo :)


salu2
Jordi

On 8/16/06, Jose Luis Rivero (YosWinK) <yoswink@gentoo.org> wrote:
> Hola a todos:
>
> Tras la reciente aprobación de la normativa del grupo[1], ha llegado el
> momento de comenzar a ponerla en práctica. Lo único que necesitamos es
> elegir el mecanismo mediante el cual registraremos qué documento está
> asignado a cada responsable y que tareas sobre documentos libres se
> están llevando a cabo actualmente.
>
> Hay un par de posibilidades para esto:
>
> 1. Utilizar trads.rb
>
> Trads.rb es un script (en ruby) que se encarga de generar una lista, con
> información muy completa sobre el estado de la documentación. Podeis
> verlo en la página del grupo francés [2] o polaco [3].
>
> Puntos fuertes:
>
> a) Muy potente
>
> Puntos débiles:
>
> a) Necesita una máquina host con el repositorio gentoo, solamente
> disponible para desarrolladores.
>
> b) Se basa en el concepto de revisión cvs, en lugar de versión xml como
> tiene overview, teniendo que notificarse manualmente (por medio del
> desarrollador) cada vez que se realiza algún commit al cvs, para
> reflejar que el documento está actualizado.
>
> 2. Lista de responsables sobre overview
>
> Actualmente trabajamos con overview.xml [4], me parece la manera más
> sencilla de comprobar el estado de la documentación. Si a esto le
> añadimos una columna más con el responsable, creo que tenemos todo lo
> que nos hace falta. Algo así como lo que tienen los italianos [5], pero
> más completo.
>
> He implementado un feo hack[6] en python, que hace esto mismo: descarga
> el overview.xml actual y le añade una columna de responsable, colocando
> en cada documento el responsable que le corresponde que lee de un fichero.
>
> Puntos fuertes:
>
> a) Muy automático: actualiza el overview via cron dos veces cada día, no
> es necesario que ningún desarrollador marque nada cuando se hace un
> commit, el propio overview reflejará la actualización.
>
> b) Todos los desarrolladores (chiguire, anpereir y yo, actualmente)
> pueden ejecutar el script (ya que está en nuestra máquina
> dev.gentoo.org) y, lo que es más importante, modificar el archivo de
> responsables, salvando de esta manera un posible cuello de botella en
> caso de que uno no esté disponible.
>
> Puntos débiles:
>
> a) Es un feo feo hack sobre el html del overview que seguramente nunca
> debió escribirse, pero se aceptan soluciones mejores con el mismo
> resultado ;)
>
> b) Inconsistente frente a cambios (serios) en el overview.
>
> El script lleva funcionando dos semanas, sin errores. Además, como
> medidad de detección de errores, comprueba si algún
> documento/responsable en el fichero de responsables no fue asignado y,de
> ser así, envía un correo notificandolo (sucede cuando se elimina un
> documento del overview o si hubiera algún cambio en el propio html).
>
> A parte de esto, para las tareas que se realizan sobre documentos
> libres, seguiremos empleando gentoo.es[7] como hasta el momento. Lo
> único que no será necesario que los responsables notifiquen allí nada
> cuando trabajen sobre sus docs.
>
> Yo personalmente prefiero evitar todo el trabajo manual, por parte de
> una sola persona que conlleva trads.rb. Quizá pueda estar equivocado,
> pero sería crear un cuello de botella o una dependencia de alguien excesiva.
>
> Ideas, flames, dudas ... ?
>
> Un saludo.
>
> [1] http://dev.gentoo.org/~yoswink/doc/es/
> [2] http://dev.gentoo.org/~neysx/
> [3] http://dev.gentoo.org/~rane/trads.xml
> [4] http://www.gentoo.org/doc/es/overview.xml
> [5] http://dev.gentoo.org/~so/
> [6] http://dev.gentoo.org/~yoswink/tmp/gen-doc-es/over-extended.html
> [7] http://www.gentoo-es.org/project/issues/125
>
> --
> Jose Luis Rivero [yoswink@gentoo.org]
> Gentoo/Doc Gentoo/Alpha
> --
> gentoo-doc-es@gentoo.org mailing list
>
>


-- 
Jordi Molina Casas (warp3r)
mail: warp3r@gmail.com
www: www.warp3r.com

-- 
gentoo-doc-es@gentoo.org mailing list

Re: [gentoo-doc-es] Gestión de responsables y tareas

[Jose Luis Rivero (YosWinK)]

Jordi Molina wrote:
> Duda:
> como indicamos en los documentos quien es el responsable?
> 
> Supongo que es un tag xml, pero seria bueno saberlo :)

La organización del grupo no está pre-establecida por GDP (Gentoo 
Documentation Project) de manera que se deja a cada uno su propio 
gestión y autoorganización.

La figura del responsable surge de *nuestra* manera de trabajar, pero 
realmente es algo más 'lógico' que 'físico'. El responsable únicamente 
aparecería en nuestro documento (trads.rb u overview-ext.xml).

En los documentos realmente sólo se reflejaría como "Traductor" de la 
misma manera que se realiza ahora.


> 
> 
> salu2
> Jordi
> 

Un saludo jordi.

-- 
Jose Luis Rivero [yoswink@gentoo.org]
Gentoo/Doc Gentoo/Alpha
-- 
gentoo-doc-es@gentoo.org mailing list

Re: [gentoo-doc-es] Gestión de responsables y tareas

[Jose Luis Rivero (YosWinK)]

Hola a todos:

Señores, espero que el verano les haya sentado bien (para los que hayan 
tenido vacaciones) y el regreso a la actividad no sea demasiado traumático.

El siguiente paso (y creo que es el último) para poner a funcionar el 
sistema de responsables sobre los documentos, es realizar una lista con 
la gente que ha estado trabajando de "responsable no oficial" y 
oficilizar su posición. En principio nada traumático, pero me gustaría 
seguir un par de reglas:

1. Las peticiones se mandan *fuera* de la lista, con destinatario 
yoswink@gentoo.org y CC chiguire@gentoo.org.

2. Abstenerse de solicitar el estado de responsable sobre un documento, 
aquella persona que no haya contribuido al mismo durante los últimos 4 
meses o, si no hubieran existido cambios en los últimos 4 meses, al 
menos haber realizado las últimas aportaciones.

3. En el caso (creo que no deberían producirse muchos, si seguimos la 
segunda norma) de que dos personas reclamen el estado de responsable del 
mismo documento, se pondrá en comunicación de las mismas y esperaremos 
un acuerdo amistoso ;) (ooh yeah! la vida es rosa) De no producirse 
(*shrug*) los responsables del proyecto decidirán en función de las 
fechas de las aportaciones y su dimensión.

Se recuerda para todas aquellas personas que quieran hacerse responsable 
de mantener algún documento que el procedimiento oficial para esto es: 
primero se realiza una actualización sobre el mismo y posteriormente se 
pide el estado de responsable, como reflejan las normas del grupo[1].

Nada más, muchas gracias a todos.

Un saludo.

-- 
Jose Luis Rivero [yoswink@gentoo.org]
Gentoo/Doc Gentoo/Alpha
-- 
gentoo-doc-es@gentoo.org mailing list

Re: [gentoo-doc-es] Gestión de responsables y tareas

[Jose Luis Rivero (yoswink)]

Jose Luis Rivero (YosWinK) escribió:
> [snip] 
> El siguiente paso (y creo que es el último) para poner a funcionar el 
> sistema de responsables sobre los documentos, es realizar una lista con 
> la gente que ha estado trabajando de "responsable no oficial" y 
> oficilizar su posición.

Finalizado, muchas gracias a todos por la colaboración.

Pues, si todo el mundo está de acuerdo y nadie tiene nada que decir en 
el último momento (como en las bodas) desde hoy tenemos funcionando la 
nueva normativa[1] y la lista de responsables[2].

No hay ninguna sorpresa para aquellos que hayais seguido la discusión en 
esta lista. De hecho, lo único que hemos hecho ha sido formalizar 
ligeramente lo que veníamos haciendo desde hace mucho.

Si os resulta más sencillo de recordar, podeis usar la siguiente url, 
donde se encuentran los enlaces relevantes:
http://dev.gentoo.org/~yoswink/doc/es/

Un saludo a todos.

[1]http://dev.gentoo.org/~yoswink/doc/es/normativa.xml
[2]http://dev.gentoo.org/~yoswink/doc/es/status/index.html

P.D1: Los enlaces rotos que se aprecian en los documentos, que deberían 
apuntar a gentoo.org en lugar de dev.gentoo.org, están esperando a que 
infra termine de resolver el bug #133455.

P.D2: Lo siguiente, el manual de traducción. Necesito algo de tiempo, 
que estos días lo tengo díficil :)

-- 
Jose Luis Rivero <yoswink@gentoo.org>
Gentoo/Doc Gentoo/Alpha
-- 
gentoo-doc-es@gentoo.org mailing list