Israel Saeta Pérez escribió: > 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.
Muy bien. > 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. Lo entiendo perfectamente. Una buena alternativa sería que los usuarios registrados pudiéramos valorar la facilidad de comprensión de cada documento y señalar de alguna forma aquellas partes que más trabajo nos cuesta comprender. No es necesario que estas evaluaciones sean públicas, pero si estuvieran a vuestra disposición, las medias resultantes podrían ser de gran utilidad, tanto para el correspondiente editor, como para el equipo de coordinación de estos recursos (y, lógicamente, a posteriori, para todos los usuarios de Plone). Creo que los procesos de evaluación colectiva son muy importantes para poder localizar las cosas a mejorar. > 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>. Perfecto: a eso me refería (la ignorancia me ha hecho sugerir algo que ya se está haciendo...). > 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. ;-) Gracias a vosotros. \ ;-) Abrazos: Manuel > -- israel > > > ------------------------------------------------------------------------ > > _______________________________________________ > Plone-ConoSur mailing list > [email protected] > http://lists.plone.org/mailman/listinfo/plone-conosur _______________________________________________ Plone-ConoSur mailing list [email protected] http://lists.plone.org/mailman/listinfo/plone-conosur
