[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