Re: [Health-es] Proceso de revisión y mejora de documentación en español

[Maria Cecilia Santos Popper]

Hola Mauricio,

he recibido algunos aportes de documentación, mas que nada relacionadas con la instalación y puesta a punto del sistema.

Lo que voy a empezar a hacer es ir agregando en el wiki book esta documentación para que la vayamos revisando entre todo, les parece?

2014-10-03 15:57 GMT-03:00 Mauricio Baeza <address@hidden>:

Hola Ceci...

Pues ya paso más de una semana, no se si alguien más te haya contactado para esto, si no, propongo que empecemos con lo que hay y veremos quien se suma... ¿te parece?


Saludos

On Wed, 2014-09-24 at 17:10 -0300, Maria Cecilia Santos Popper wrote:

Hola Mauricio!

Gracias por los aportes!
Creo que una semana para recibir la documentación es buen período de tiempo.

Respecto de que instrumento utilizar para escribir documentación técnica, me estaba preguntando que utilizar. Al final opté por el viejo y querido txt pero obviamente no es un entorno colaborativo. Podríamos incursionar en Sphinx con Markdown (no RST?) y armar un repo github para publicar allí todos los borradores? O podríamos utilizar la Wiki directamente.
Tal vez en este punto nos sirva tu experiencia o la experiencia de otros para obtener mejores resultados.

2014-09-23 19:59 GMT-03:00 Mauricio Baeza <address@hidden>:

On Tue, 2014-09-23 at 17:59 -0300, Maria Cecilia Santos Popper wrote:

address@hidden:
Durante el Encuentro Latinoamericano desarrollado el pasado Sábado 20 en Entre Ríos (Argentina) se esableció la necesidad de iniciario un proceso de revisión y mejora de la documentación de GNU Health, con especial "urgencia" en mejorar la versión en español.
Es por ello que me he ofrecido como voluntaria para coordinar esta tarea.
Creo que se podría dividir esta tarea en tres actividades separadas: 1) compilar y consolidar toda la información actualmente disponible, 2) segmentar la documentación por perfiles (una documentación para usuarios finales, otra para administradores y otra para desarrolladores, 3)Realizar una sección de FAQs
Para empezar por la tarea 1 creo que la mejor manera de organizar el trabajo es la siguiente (aunque desde ya, todas las sugerencias serán bienvenidas).
1. Compilar toda la documentación en español circulante (tanto la oficial publicada en las Wikis, como la no oficial que puedan utilizar todos uds. en sus implementaciones individuales). La idea sería compilar y evaluar toda la documentación disponible y consensuar una versión consolidada con toda la comunidad hispano-parlante. Desde ya que la colaboración con la documentación que posea cada uno es voluntaria, pero sería importante contar con la mayor cantidad de "versiones" que reflejen diferentes formas de hacer las cosas.

Por lo tanto, los invito a que me envíen (sugiero hacerlo en forma privada para evitar sobrecargar la lista) aquella documentación con la que quieran colaborar en este proceso.

Desde ya, que toda otra sugerencia y colaboración será mas que bienvenida.

Saludos!

Cecilia

--
Lic. Cecilia Santos Popper

Hola Cecilia...
Hola a todos...
Si, hace mucha falta este trabajo de revisión y mejora de la documentación...

Una búsqueda rápida de documentación para GNU Health en varios buscadores devolvía casi siempre el wikibook que todos conocemos: http://en.wikibooks.org/wiki/GNU_Health por lo que creo que hay mucho por hacer, ojalá que varios de los compañeros hayan documentado su experiencia al instalar y usar por lo que es interesante esta iniciativa... la lista no tiene mucho trafico, por lo que creo que en primera instancia podemos seguirla usando, en cuanto crezca un poco el flujo se puede pensar en una forma alterna de comunicación...

Tengo algo de experiencia de escribir documentación técnica y he usado casi de todo, txt, html, odt, wiki y últimamente estoy muy contento con Sphinx/Markdown que te permite de una forma sencilla tener excelente documentación.

Por supuesto para la revisión colaborativa se requiere un entorno colaborativo; Wiki, Github, Seafile, etc...

Me parece correcta la estrategia que propones, para el punto 1, creo esperar un tiempo prudente (¿1 semana?) para ver quien tiene algo más de documentación, si no, partir del Wikibook que tiene mucha información rescatable...

Para el punto 2, yo lo dividiría en: Instalación, Administración y Uso, que es casi lo mismo que tu tienes, el punto de Instalación me parece prioritario, sin sistema instalado no se puede avanzar en otros puntos y ha sido un tema que produce muchas preguntas en esta lista...

Quedo a la espera de más comentarios de la comunidad y al seguimiento de este importante tema...

Un abrazo

Mauricio Baeza

--

Lic. Cecilia Santos Popper

Santa Fe
(0342) 154 440 615
www.linkedin.com/in/ceciliasp/

--

Lic. Cecilia Santos Popper

Santa Fe
(0342) 154 440 615
www.linkedin.com/in/ceciliasp/