Gentoo Archives: gentoo-doc-es

From: Jordi Molina <warp3r@×××××.com>
To: gentoo-doc-es@l.g.o
Subject: Re: [gentoo-doc-es] Gestión de responsables y tareas
Date: Wed, 16 Aug 2006 09:14:07
Message-Id: 647a40580608160213w48dc80a6i219f9bae3e0ec6c4@mail.gmail.com
In Reply to: [gentoo-doc-es] Gestión de responsables y tareas by "Jose Luis Rivero (YosWinK)"
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@g.o> 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@g.o] > Gentoo/Doc Gentoo/Alpha > -- > gentoo-doc-es@g.o mailing list > >
-- Jordi Molina Casas (warp3r) mail: warp3r@×××××.com www: www.warp3r.com -- gentoo-doc-es@g.o mailing list

Replies

Subject Author
Re: [gentoo-doc-es] Gestión de responsables y tareas "Jose Luis Rivero (YosWinK)" <yoswink@g.o>