Documentación
Creación de nueva documentación
Nunca alcanza el tiempo para poder documentar todo lo que realiza el grupo :), tanto sobre desarrollo de software como sobre otras actividades. Es por eso que se aprecia mucho la ayuda en ésta tarea.
También se puede realizar documentación propia sobre temas relacionados con el grupo o con temas de interés para el mismo.
Para realizar una documentación, seguir lo siguientes pasos:
- Comunicarlo al grupo indicando: temática, idioma (español y/o ingles), tipo de licencia a utilizar. La licencia que normalmente utilizamos es la Creative Commons Atribución 2.5 Argentina, pero con ser una licencia libre alcanza
- Enviar la documentación para su revisión.
- Una vez revisada será publicada en el sitio web. Y debe ser anunciada la disponibilidad de la misma, por parte del creador, tanto en la lista del grupo como en el foro.
El formato a utilizar para el documento debe ser un formato abierto, como ODF o texto plano. Dado el caso particular puede enviarse un PDF, pero antes comunicarselo al grupo.
Traducción
La traducción de toda la documentación, que el grupo posee, al ingles es necesaria para la mayor difusión del proyecto como también para mejorar su utilización fuera del país. También puede darse el caso de que la documentación original sea en ingles, por lo que su traducción al español es también necesaria.
Para realizar la traducción de alguna documentación del grupo, seguir los siguientes pasos:
- Comunicarlo al grupo indicando: documento a traducir, idioma al cuál se traduce (español o ingles). La licencia a utilizar es la misma del documento a traducir, utilizando cuando sea posible la versión en el idioma al cual se traduce.
- Enviar la documentación para su revisión.
- Una vez revisada será publicada en el sitio web. Y debe ser anunciada la disponibilidad de la misma, por parte del creador, tanto en la lista del grupo como en el foro.
El formato a utilizar para el documento debe ser un formato abierto, como ODF o texto plano. Dado el caso particular puede enviarse un PDF, pero antes comunicarselo al grupo.
Corrección
La corrección de la documentación, en español o en ingles, permite mejorarla y mantenerla actualizada.
La correción no sólo puede ser ortográfica o lingüistica, sino también técnica.
Para enviar una corrección se debe crear un archivo diff o en caso de que sea una corrección menor indicarla poniendo la correspondiente referencia.
Cualquier corrección debe ser enviada directamente al grupo de desarrollo lugro-mesh-dev_at_lugro.org.ar.