[Plone-conosur] Cambios previstos en la documentación de plone.org
Israel Saeta Pérez
dukebody en gmail.com
Jue Dic 4 00:26:55 UTC 2008
Como ya os comenté en un mensaje anterior, hemos tenido una reunión en la
que se han tomado decisiones sobre una serie de temas. A falta del resumen
oficial de JoAnna Springsteen, os presento el mío propio:
- La documentación se dividirá en parte dos partes:
- Una oficial, en la que se seguirán procesos de revisión, actualización
y control de calidad dirigidos por los editores, pero que puede
ser escrita
por cualquier miembro de la comunidad de Plone.
- Una abierta de estilo wiki, con páginas que cualquiera podrá editar
sin pasar por el proceso de revisión de la documentación oficial. Se
diferenciará claramente de la oficial y se encontrará en un
subdominio del
tipo algo.plone.org.
- Se tiene la intención de usar Sphinx para la documentación de
referencia de los módulos que componen Plone. Se llevará a cabo una
experiencia piloto con algún módulo para ver qué tal funciona.
- La documentación oficial se intentará organizar en manuales sobre cada
tema (uso básico, theming, formularios, etc.), cada uno con una introducción
rápida primero y luego una guía comprensiva sobre el tema. Se intentará
encontrar un lugar en los manuales para toda documentación nueva que se
escriba.
- Se eliminará la división del Plone Help Center actual por tipo de
contenido en la parte oficial, es decir, adiós a las URLs tipo
plone.org/documentation/tutorial, plone.org/documentation/howto, etc.
- Se intentará que los PLIPs incluyan información para facilitar la tarea
de documentar los cambios que introducen. Estamos en contacto con el
framework-team para conseguirlo.
- Se eliminarán los comentarios de los artículos oficiales de
documentación. Los errores y mejoras de un artículo se registrarán y se
administraran con el sistema Trac general de Plone, como bugs en la
documentación.
- Se eligieron tres cargos especiales en el equipo de documentación:
- Veda Williamson, responsable de asuntos políticos y de presentación
(theming principalmente).
- Steve McMahon, responsable técnico y enlace con la Plone Foundation.
- JoAnna Springsteen, pastora de nuestro rebaño de editores.
Por otra parte, Aleksandr Vladimirskiy (aka shurik) ha dimitido como editor
de la sección "Users, Authentication and Permissions". Cualquier ayuda será
bienvenida.
-- israel
------------ próxima parte ------------
Se ha borrado un adjunto en formato HTML...
URL: <http://lists.plone.org/pipermail/plone-plone-conosur/attachments/20081204/76546473/attachment.html>
Más información sobre la lista de distribución Plone-ConoSur