Libro blanco de las tecnologías de documentación de LuCAS: Descripción, funcionamiento, herramientas y futuro del proyecto de documentación LuCAS | ||
---|---|---|
Anterior | Creación en LuCAS: Ejemplos | Siguiente |
En un proyecto de traducción o revisión, aparecen en LuCAS dos grupos de roles.
El líder. Es la persona encargada de coordinar todo el proceso. El líder debería conocer:
Las herramientas de autor utilizadas en el documento (LaTeX, Docbook).
la estructura completa de archivos del documento.
los recursos LuCAS, por ejemplo el CVS, ya que en este caso será el responsable absoluto del árbol CVS de ese proyecto.
Traductores o revisores. Son las personas que, a las órdenes del líder, van realizando el trabajo asignado por éste. También deben tener conocimientos técnicos similares a los del líder, pero en menor medida. Así será deseable que el colaborador conozca:
la herramienta de autor usada, pero este conocimiento puede limitarse a distinguir el texto a traducir de cualquier etiqueta o atributo del mismo. También,
manejo básico CVS: subir cambios, actualizar y resolver conflictos.
Las fases que se siguen con la puesta en marcha de un proyecto de esta clase serían:
Planteamiento de la idea: el futuro coordinador se plantea la idea de traducir o crear un nuevo documento.
Presentación de la idea al resto de los miembros de LuCAS, con el fin de obtener apoyos y colaboraciones necesarios.
Se establece un plan de trabajo, es decir, se divide el trabajo a realizar en las secciones que se asignarán a cada colaborador. Este plan se realiza teniendo en cuenta, el plazo para el que se quiere terminar el trabajo, los colaboradores disponibles y la cantidad de trabajo diario asumible por cada colaborador (páginas diarias).
A lo largo del proceso, hay una comunicación entre todos los miembros del proyecto, mediante la lista de correo, con el fin de discutir aspectos terminológicos, técnicos o cualquier otra duda que surja. También mediante este medio, el coordinador comunicará a todos los miembros el estado del desarrollo (capítulos entregados, capítulos pendientes, capítulos fuera de fecha que deben ser reasignados...).
Tan pronto como sea posible, y cuando el coordinador lo considere conveniente, se montará y publicará una versión alfa del documento, con todo lo realizado hasta el momento. Esta versión se publicará y servirá también para que la comunidad de usuarios pueda conocer la evolución del proyecto.
Cuando los miembros del proyecto tengan todos los capítulos traducidos, o en un alto porcentaje, el coordinador puede decidir crear el equipo de revisión del documento.
Por refinamiento progresivo se van lanzando nuevas versiones del documento, mejor traducidas y con menos errores. Esto correspondería casi a la fase de mantenimiento del ciclo de vida, y por tanto no tiene un fin previsto: el coordinador puede decidir en cualquier momento el lanzamiento de una nueva versión.
Esta enumeración de fases es orientativa, y en cada caso particular puede variar poco o bastante. Por ejemplo, hay coordinadores que no publican ninguna versión del documento hasta estar totalmente traducido, y en otros casos se prefiere liberar la primera versión alfa cuando hay un porcentaje traducido suficiente (por ejemplo, del 60 por ciento).
Mediante CVS el coordinador del proyecto puede facilitar la entrega de capítulos por parte de los colaboradores, e incluso facilitar que éstos puedan tener en sus sistemas copias completas del documento parcialmente traducido, de manera que puedan ellos mismos revisar su trabajo generando formatos de salida mediante la herramienta utilizada (LaTeX, etc).
El coordinador deberá crear una base de trabajo con todos los ficheros que forman parte del paquete a traducir (incluyendo también aquellos que no se traducen, como los makefiles).
Tras la asignación de trabajos, cada participante accederá por CVS a los ficheros del proyecto, los irá modificando y enviando las versiones nuevas al CVS.
Periódicamente, o en el momento de generar una versión alfa del proyecto, el coordinador extraerá todos los ficheros de la base de trabajo y hará el trabajo de integración y generación, es decir, corregirá errores de sintaxis de la herramienta usada (LaTeX, etc) para conseguir generar versiones de salida del documento, que publicará. Al tiempo, el coordinador enviará al CVS los ficheros que haya modificado para que los colaboradores puedan seguir trabajando con los ficheros ya corregidos.
El líder debe intentar aplicar sus capacidades de liderazgo para conseguir, en la medida de lo posible, cumplir las fechas de liberación de versiones. Para ello, podemos dar algunas indicaciones orientativas:
Consultar a los colaboradores cuántas páginas diarias están dispuestos a traducir o revisar. Debe exigírseles a los colaboradores un suficiente compromiso para realizarlo: de nada sirve que nos digan que pueden realizar 15 páginas diarias si luego entregan 10 al mes.
Repartir el trabajo con los datos anteriores. Si tenemos suerte de que haya colaboradores sin trabajo asignado, dejarlos en una lista de reserva. Crear con todo esto una tabla de colaboradores, trabajo asignado y estado del mismo. Un trabajo asignado puede tener, por ejemplo, los estados:
Asignado,
Trabajando,
Entregado,
Reasignado, etc.
Cuando se aproxime la fecha de entrega de un trabajo, contactar con el colaborador, para animarle a cumplir la fecha y preguntarle el estado del trabajo. La realimentación del colaborador es muy importante.
Finalizado el plazo de entrega, dar un margen con los correspondientes avisos al colaborador que no ha cumplido las fechas. Si éste no confirma su continuidad o indica que no puede continuar, reasignar el trabajo a otro colaborador de los que ha finalizado o bien de la lista de reserva.
Comunicar con frecuencia el estado del proyecto (tabla de capítulos y estado) a todos los colaboradores.
El objetivo es obtener un trabajo de calidad suficiente dentro de los plazos previstos. Los retrasos son casi siempre inevitables, pero se pueden reducir en gran medida con un trabajo adecuado.
En LuCAS, como en tantos otros sitios, es la capacidad motivadora y de liderazgo del coordinador la responsable última del éxito de un proyecto.