2008/12/7 Manuel Gualda Caballero wrote: > Un par de sugerencias de un principiante: > > 1.- Sería interesante que los usuarios registrados pudiéramos valorar la > utilidad de la documentación. Imagino que así la más útil para la > mayoría de la gente aparecería en los primeros puestos dentro de cada > categoría si el visitante eligiera esta opción de ordenación. Esto > podría ser un buen complemento al orden que por razones técnicas y > pedagógicas estimen conveniente los especialistas.
Esto tiene mucho (muchísimo) sentido en la parte "collective" de la documentación, pero no tanto en la parte oficial, ya que si sólo hay un manual de cada tema (formularios, archetypes, etc.), como queremos que haya, no hay nada que ordenar. 2.- Entiendo las razones por las que el esfuerzo de documentación se > centraliza en inglés. Aunque sugeriría que para ayudar a conseguir el > objetivo que entiendo se persigue con esta decisión (accesibilidad del > conocimiento al mayor número posible de personas), se intente que la > redacción sea lo más sencilla posible. En todos los idiomas hay muchas > maneras de decir una misma cosa, desde la más sencilla, hasta la más > enrevesada. Si se quiere que los no especialistas en inglés entiendan el > mayor número posible de explicaciones, lo ideal sería optar por la > sencillez en la redacción. > Esto es complicado, porque no me veo rechazando el documento de alguien por estar escrito en un inglés complejo. Por supuesto, intentamos que todos los documentos sean lo más claros posibles, y damos algunas pistas para conseguirlo<http://plone.org/documentation/tutorial/creating-documentation-for-plone.org/writing> . De todas formas, estoy seguro de que muchos documentos están escritos por personas cuya lengua madre no es el inglés, así que no creo que se use un vocabulario ni una gramática especialmente complejo. Aun así, pondré especial atención a que la redacción sea sencilla cuando revise los nuevos documentos. ¡Muchas graciasa por tu interés y tus aportaciones! Las opiniones de los que se llaman a sí mismos principiantes son muy importantes para nosotros. ;-) -- israel
_______________________________________________ Plone-ConoSur mailing list [email protected] http://lists.plone.org/mailman/listinfo/plone-conosur
