La documentación, altos y bajos

  • por

La documentación de Latino como todo lenguaje de programación, tiene una documentacion y no puede ser de otra manera que para latino sea en español, pero ha sido sin duda un punto debil, inicialmente nadie la queria hacer, creo que los colaboradores le tenían alergia, les daba sarpullido a unos y a otros dolores de cabeza de solo pensar que se debia escribir

Y si, es importante ya que sin ella por más bueno que sea el sistema, si la gente que la desea usar no sabe lo que tiene a disposición simplemente el sistema queda en un rincon, hasta que tiempo despues se empezo a crear la doc en google drive, y rapido nos dimos cuenta que no esra la mejor manera, hubo intentos de crearla como la doc que viene en linux, pero también alli quedo para el recuerdo, otro intento fue crearla en gitbook, antes que esta empresa pase a otro sistema para la documentación y nos quedamos colgdos tambien con ese sistema, se paso tambien a ponerla en el repo de github en las tripas mismas de Latino, al final nos encontramos con un monton de lugares donde hay pedazos y horas de trabajo dispersas en diferentes sistemas para la gestion de la documentacion.

A cada vez que pasa algun nuevo colaborador se pasa también a un nuevo sistema para la doc, finalemente ya no más horas de trabajo dispersas, ya no mas sistemas diferentes, ya no mas cada uno por su lado, para ello se ha creado un sistema en php, Mysql, HTML, CSS, este sistema esta creado especialmente para la gestión de la doc, por eso ya no se acepta más sistemas externo

Otra ventaja con tener un sistema que gestiona la documenation en nuestros servidores y con una herrameinta creada para ello es que podemos tener total control de la presentación sea este en una web o en PDF, XML, SQL, CSV, json … o cualquier otro formato sea este para usos internos o externos en otros sistemas como editores de texto por ejemplo, que pueden leer la doc desde aca

Este sitio ya usa de la documentacion de Latino usa la misma base de datos, asi que podemos dar acceso a cualquier sistema a que consulte la documentación y gratis como nos gusta a todos, pero también puedes pagarnos un café para contribuir con el proyecto.

Ha y no se diga sobre las estadisticas detalladas que podemos tener, claro que también has desventajas, entre ellas es que hay que desarrollar el sistema para la gestion de la doc, (más trabajo, como si no tuvieramos suficiente) hay que convencer a los demas colaboradores que este es la mejor opción a futuro (labor que se ha dado dificil últimamente)

Concretamente: en este momento hay dos documentaciones, 1) http://manual.lenguaje-latino.org/ que habla de mandera general sobre latino, una especie de libro, donde se explica que es, para que sirbe, como se instala en diferentes sistemas operativos, etc etc. puedes leer este articulo para saber como se crea esta documentacion; 2) http://documentacion.lenguaje-latino.org es una documentacion exclusivamente para dar explicacion de como usar latino, sus funciones, etc. Quieres saber como pasar un texto a mayusculas en latino? es en esta documentación que te explica.

Para los colaboradores: Si quieres colaborar con la edicion, corrección de faltas de ortografía (que hay un choro) , agregar más información en esta, puedes hacerlo de la siguiente manera:

Para editar http://manual.lenguaje-latino.org/ sigue estas instucciones:

Para editar http://documentacion.lenguaje-latino.org debes pedir que se te cree un usuario y clave para que puedas editarla, y entra aca

Latino es un lenguajes de programación en español y como todo proyecto tiene sus altibajos y este es uno de ellos

Deja una respuesta