|
From: Diego C. <ma...@so...> - 2003-08-11 20:15:06
|
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 |