Procedimiento para Actualizar la Documentación

Presentación

Modus Operandi

Prioridades

Colaboradores

Aclaraciones




¿Que tipo de conexión tienes con Internet?


Permanente

Pago por consumo



Con acceso a internet permanente.

¿Tienes cuenta de acceso al servidor CVS del proyecto?


SI

NO



Con acceso al CVS del proyecto.

En este caso, asumiré que ya te has descargado el arbol doc-postgresql-es completo.

En estas condiciones tienes ya en tu PC la rama V6, en el que todos los documentos se encuentran en la versión actual de traducción (prácticamente todos en español), y la rama V7, que tiene la versión que queremos actualizar.

Conectate a la página cvsweb del proyecto (http://cvs.hispalinux.es/cgi-bin/cvsweb/doc-postgresql-es/), y navega por el directorio "diferencia" hasta llegar al fichero que se te ha asignado, que salvo tratamientos especiales puede encontrarse bajo src/sgml/ o src/sgml/ref/

Si se encuentra en versión 1.1, es que es un fichero que quedó obsoleto en la versión 6.5.3, y no hay que actualizarlo. Se deben tratar sólo los que se encuentren en 1.2, al menos.

Si hay más de dos versiónes, (1.1, 1.2 y otra/s), marca en la 1.1 como "select for diffs". Si sólo hay dos no hace falta.

Ahora ve a la más alta que encuentres, normalmente la 1.2, y pincha en "diff to previous ... selected 1.1 (colored)"

Se trata de ver la diferencia entre la versión que hay como más alta y la que hay como inicial.

Si todo ha ido bien, estarás viendo un resumen del documento original en inglés que tienes que actualizar, con algunas marcas de diversos colores. Bien, esas marcas marcan (sorry) las diferencias entre la versión 6.5.3 y la versión 7.1.2.

Ahora nos vamos en nuestro propio pc a la rama v6 del cvs, y buscamos el fichero a actualizar. Antes de hacer otra cosa, lo copiamos sobre el mismo fichero de la versión v7, que es sobre el que vamos a trabajar directamente Normalmente debe de estar en algo parecido a correcto castellano.

Bien, pues se trata de ir introduciendo las diferencias que hemos encontrado en la vista en color, adecuadamente traducidas, en su posición en la versión española.

Y una vez demos por terminada la actualización del fichero, ahora sobre la rama v7, la subimos al cvs con el comando cvs ci fichero que ya conocemos.

Acto seguido enviamos un correo a los cuatro constructores, a Roberto y a Eduardo, para que puedan llevar el adecuado seguimiento del estado del proyecto.

Sin cuenta en el cvs del proyecto.

Accedemos a ver las diferencias del mismo modo que si tenemos "Acceso al cvs del proyecto".

Nos cambiamos a la rama v6 del cvs del proyecto, y navegamos hasta ver nuestro fichero. Cuando lleguemos, nos descargamos la última versión que aparezca. (Botón derecho sobre el enlace "download" suele preguntar lo que se quiere hacer con el enlace: pues eso, que "guardarlo como...")

Y ahora trabajamos sobre el fichero que nos acabamos de descargar como si lo tuviesemos en la rama v7 del cvs.

Una vez hemos terminado, le enviamos un correo (el mismo, no hace falta que os repitais ;-P) a los cuatro constructores, a Roberto Santos y a Eduardo Maldonado, para que ellos se ocupen de subirlo a cvs e ir realizando las tareas de maquetación y demás oportunas. No olvideis indicar en el correo que se trata de una actualización a v7.

Y procurar no cambiar el nombre al fichero, o nos volveremos locos.

Con conexión de pago por consumo.

Tranquilos, que no pasa nada. Revisamos en el punto de "Con acceso al cvs del proyecto" los pasos para localizar las diferencias entre las dos versiones del fichero.

Nos guardamos la página que estamos viendo en el mismo PC, utilizando las capacidades que tienen todos los navegadores. De esta forma nos podremos desconectar enseguida, y podremos seguir estudiando estas diferencias.

Y ahora nos comportamos como los que tienen conexión permanente a internet pero no tienen acceso al cvs: primero navegamos hasta el fichero asignado en la rama v6 del cvsweb, y nos lo descargamos a nuestro pc.

Una vez descargado, ya podemos desconectarnos hasta que terminemos de actualizar.

Una vez actualizado, se lo enviamos por correo electrónico a los cuatro constructores, a Roberto y Eduardo, para que lleven el seguimiento y lo suban ellos al cvs.

Conclusiones y petición de sugerencias.

Bueno, ha sido fácil, ¿no? ¿Que no entendéis nada? Pues no me extraña: tengo conciencia de mí de que necesito un curso urgente de comunicación interpersonal.

En fin, que ya sabéis que se admiten todo tipo de sugerencias. Enviadlas a la lista, y así las comentaremos entre todos.