Re: [Jamesproject-devel] web de james

[Diego C. <ma...@so...>]

On Mon, 2003-08-11 at 17:04, Ricardo Varela [phobeo] wrote:
[..]
> 1) tema documentacion
> 
> Con que documentamos JAMES? USamos OpenOffice y exportamos a varios
> formatos? Usamos un wiki para que los usuarios editen la documentacion? Que
> usamos como fuente: html, rtf, ...? Como hacemos accesible a todo el munod
> la posibilidad de modificar/traducir la documentacion?

Hacerla con openoffice presenta el problema de que sólo uno puede
modificarla a la vez. Y puede dar el típico problema que al meter mano
más de uno se termine generando 800 versiones del mismo fichero, cada
una de ella con algún arreglo. Habría que tener algún coordinador o algo
así, que se encargarse de tener una versión correcta y las
modificaciones a la documentación se le enviase a éste. Por lo que se
necesitaría una persona con mucho tiempo libre. Por otro lado, se tiene
la ventaja de que un documento maquetado con openoffice es mucho más
vistoso.

El sist. de wiki tiene la ventaja de que cualquiera puede editarla y que
los usuarios podrían enviar sus correcciones. El problema sería que
siempre puede estar por ahi el usuario malicioso que haga alguna
trastada en la documentación y detectar la "gracia" implicaría revisar
la documentación de forma metódica. Demasiado trabajo vamos.

El usar como fuente html, rtf o cualquier otra cosa presenta los mismo
problemas que openoffice. Asi que no repitiré lo mismo.

Mi proposición es usar algo mixto, similar a la documentacion de php.net
Subir la documentación de forma estática, y que la gente pudiese subir
comentarios que apareciesen a pie de página. De esta forma podría haber
un encargado de la documentación como en el caso primero, con formato
openoffice y una buena maquetación. Sin impedir a la gente aportar su
granito de arena.
De esta manera, y de forma periódica, el encargado revisaría las notas a
pie de página y modificaría la documentación de forma conveniente. Pero
ya no sería necesario modificarla cada vez que alguién envia una
sugerencia.

> 2) tema internacionalizacion de la web
> 
> Que metodo usamos para tener la web en varios idiomas? Todo en PHP y usamos
> un getText()? PHP+plantillas html? Webs estaticas para cada idioma?
> 
> Esos son dos puntos a votacion... Se admiten propuestas hasta la fecha
> limite del Viernes 15. Estaria bien si cada propuesta viniera acompañada de
> un ejemplito o algo (especialmente para el tema de internacionalizacion).
> 
> Pues eso, a currar (en vacaciones... si es que semos masocas) };P

Teniendo en cuenta que la web tendrá poco código dinámico, creo que la
opción más simple y cómoda es la de webs estáticas. Al fin al cabo, en
la web la mayoría del contenido es el texto que se mostrará en el
navegador y que tendrá que ser traducido.

Un saludo a la lista, Diego