Re: [Gvsig_usuarios] Re: [Gvsig_desarrolladores] Solicitud de Información

[Mario Pisa]

Hola, estoy completamente de acuerdo con Simone, el tema de la documentación
puede suponer un gran freno a la expansión de gvSIG.

Efectivamente, hay un problema de idioma a la hora de documentar las clases
(yo me decanto por el inglés, que es el más internacional). Por otro lado,
en mi escasísima experiencia con gvSIG he visto que hay clases que no están
documentadas en ningún idioma y la que lo está, su información es muy
reducida.

Pienso, y no quiero generar más polémica, que este es un escollo muy
importante a salvar para facilitar las cosas a los desarrolladores y por lo
tanto, que redunde en beneficio para el propio proyecto.

No hace falta decir lo útil u odioso que se puede convertir consultar
documentación. Una documentación ríca, llena de ejemplos, con el código bien
documentado... sería el ideal que hay que perseguir (desde mi punto de
vista, of course!)

Un saludo

On 4/12/07, César Martínez Izquierdo <cesar.martinez en iver.es> wrote:
>
> Simone Casciaroli wrote:
> > Hi Gabriel,
> > I read with more attention your mail (and with the support of a
> > translator because I don't know Spanish language).
> > I appreciate much your support in gvsig list, people of the
> > international list have responded me very quickly and with very good
> > suggestion.
> > But I think that there isn't only a documentation problem but also a
> > linguistic problem, javadoc of the source code is more often in Spanish,
> > the developer list (that is the more populated) is in Spanish. I think
> > that this problem creates a barrier for the widespread use of gvSig in
> > all the world, particularly for widespread use as development platform.
> > I don't write in English because it's better or prettier than Spanish,
> > but I use English because I think that it's the language of information
> > technology. I hope in this way that all people can understand me.
> > I don't know what is your opinion about the extension of gvSig in
> > no-Spanish country but the fact that there are localizations in all
> > principal languages is a sign of your commitment for an international
> > development.
> > Best Regards
> >
> > Simone Casciaroli
> >
>
> Hi Simone, we have been writing the Javadoc comments in English for a
> while; in this way I hope we can revert the situation in a near future...
>
> Best Regards,
> (Well, as this is the Spanish list, I'll write the same in Spanish now):
> Hola Simone, desde hace un tiempo estamos escribiendo los comentarios
> Javadoc en inglés; de esta forma espero que podamos revertir la
> situación en un futuro cercano...
>
> --
> César Martínez Izquierdo
> Equipo de desarrollo gvSIG
> http://www.gvsig.gva.es
>
> IVER T.I.
> C/ Salamanca 50
> 46005 Valencia - Spain
> http://www.iver.es
> _______________________________________________
> gvSIG_usuarios mailing list
> gvSIG_usuarios en runas.cap.gva.es
> http://runas.cap.gva.es/mailman/listinfo/gvsig_usuarios
>
------------ próxima parte ------------
Se ha borrado un adjunto en formato HTML...
URL: http://runas.cap.gva.es/pipermail/gvsig_usuarios/attachments/20070412/253c13b1/attachment-0001.htm