Re: [Plone-conosur] Cambios previstos en la documentación de plone.org

[Manuel Gualda Caballero]

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
> Plone-ConoSur en lists.plone.org
> http://lists.plone.org/mailman/listinfo/plone-conosur