Jose Luis Rivero (YosWinK) wrote:
> Bueno, el borrador está listo para la revisión por parte de todos:
> 
> http://dev.gentoo.org/~yoswink/tmp/doc-es.html

Ahí voy...

Entiendo que la principal diferencia con la organización actual es la
propuesta de la existencia de un "mantenedor oficial" de cada documento.
Creo que es una buena idea, porque por un lado ayudará a "controlar" el
estado de la documentación y por otro nos evitará alguno de los
malentendidos ocasionales que pasan de tanto en tanto.

Eso sí es importante ver, más adelante según comenta J.L., cómo se va a
materializar o evidenciar esa asignación y las herramientas que se
emplearán.

También encuentro adecuados las distintas tareas y los roles a
desarrollar, aunque igualmente sería interesante ver en concreto cómo lo
haríamos en la práctica.

Por otra parte, no me ha parecido que se mencione el overview.xml,
documento que creo muy interesante para ver tanto el general "estado de
la documentación" como en particular la que cada uno mantiene (con el
añadido del responsable del documento sería ya el no va más)

Y para acabar, un pequeño detalle. En el apartado 3, en responsables, se
podría poner en negrita el "mantenerlo actualizado" que se menciona,
puesto que creo que compartimos todos la opinión de que más vale el
documento original en inglés que una traducción obsoleta.

¡Ale!, un saludo.

--
Carles Ferrer
-- 
gentoo-doc-es@g.o mailing list