Manual y manual en inglés

edited julio 2010 in Beta2
Ya que estamos con el Beta 2, hace unos meses estuve traduciendo algunas páginas. Están parcialmente traducidas. Están en la wiki, comienzan con "English + titulo en castellano".

Un problema que encontré es que la estructura del manual está un poco enmarañada o yo no la entendí.

Que posibilidad hay de ponernos de acuerdo con esto de tal manera de que el manual no sea un stopper para que más gente adopte KumbiaPHP y para sacar nuevas versiones?

Comentarios

  • Hola pabloa estamos conciente de ese problema y en ese sentido he estado trabajando en un nuevo manual que va desde cero con nuevos ejemplos, mejor explicación, gramatica, etc...

    Como sabes no soy un experto haciendo manual y se me ha hecho lento el avance en ese sentido (el manual anterior fue heredado) sin embargo ya tengo un draft (30 pág) y estoy buscando un grupo de personas que se animen a echarme una mano con esta tarea...

    Si tienes alguna idea sugerencia beinvenida sean...

    ¡Éxitos!
  • edited 5:30
    Idealmente creo que sería bueno hacer el manual al estilo Spring MVC o alguno por ese estilo.

    Ellos (creo) lo hacen con docbook y luego generan la docu en diferentes formatos.

    Hacerlo en la wiki es una opción pero creo que estaría bueno hacer un esqueleto o estructura de tal forma de que luego podamos rellenarla.

    A su vez debería permitir algun tipo de traducción casi lineal.

    Por ejemplo: si tenemos el documento que habla del layout template, que este sea una página con un nombre apropiado como para luego crear la versión en otro lenguaje.

    Sino una estructura similar estaría buena, por supuesto con los titulos pertinentes a kumbiaphp.

    <!-- m --><a class="postlink" href="http://static.springsource.org/spring/docs/3.0.x/spring-framework-reference/html/">http://static.springsource.org/spring/d ... ence/html/</a><!-- m -->

    Saludos

    Pablo
  • He estado generando el manual con Lyx un WYSIWYM que a mi modo de ver es muy potente y simple de usar, también genera en Docbook y demas formatos...

    Me incline por la opción de Lyx porque es fácil (no pasa lo mismo con docbook) y la idea es captar gente que este interesada en ayudar a generar un manual, obviamente la idea es que se tenga conocimientos sobre gramatica, estructura y demas cosas aunque no es limitante con ganas se hacer las cosas podemos hacer bastante <!-- s:) --><img src="{SMILIES_PATH}/icon_smile.gif" alt=":)" title="Smile" /><!-- s:) -->

    Estoy interesado en versionar las +30 pág que tengo en el repositorio de KumbiaPHP y tratar de organizar un grupo interesados y como bien dices tratar de generar una docs en paralelo en otro idioma (ingles para comenzar).

    Mirate la herramienta y dame tu opinión al respecto...

    ¡Éxitos!
  • Hola pabloa hemos estado trabajando en la documentación de la versión 1.0, esta documentación la estamos generando desde Google Docs, esto por la facilidad que este permite para tener mas colaboradores en esta tarea.

    No se si aún tienes el interés de ayudar con la traducción de este manual al Ingles, sin duda que sería un gran aporta al crecimiento de KumbiaPHP y entrar en el mundo anglosajón...

    Documento GDocs: https://docs.google.com/document/d/1kth1GhrmMEBK2cAMyiy_4Dw1qlJFNdXVuXajJ6nMTQg/edit?hl=en

Sign In or Register to comment.