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

[Ginito Vo]

Estimada Amiga Cecilia,

Esta perfecto para empezar, yo llevo varios días con pruebas de instalación limpia en Ubunto 14.04, en cuanto a Ubuntu 64 Bits, esta dando un error grave, el repositorio se actualizo y baja la versión 9.3.5, anteriormente la 9.3.4 sin problemas. Estoy haciendo pruebas de todo tipo, ahora con 32 Bits comencé a hacer pruebas, aparentemente el problema es de permisos de psql server en la nueva versión, solo dandole un service postgresQL start, se puede continuar con la instalación de los paquetes necesarios. El gran tema por lo que veo es que se instala en como root, no te permite por lo que veo hasta ahora. Al correr la instalación de GNU Health, va todo bien hasta que intenta tocar psql, corriendo ya la instalación queda por la mitad. Te enviaré bien el error lo  capture, pero no lo encuentro ahora.

Referente a documentación de de manejo de GNU Helath, he avanzado mucho, capturas de pantallas y comencé de 0, mañana te paso el formato, estoy trabajando bien estudiado el Indice, si pueden colaborar sería de gran ayuda! 

En cuanto a los audiovisuales, también avance un montón, en días ya subo una muestra a ver que les parece y pa criticar, así lo podemos llevar entre todos. En cuanto a los audiovisuales de instalación me varé con esto que comento, la idea es hacer los mismos en las distintas distros, el gran tema que tengo que estar trabajando baja el bendito windows, renegado mal, el tema es producir y sacr material lo antes posible con la mayor resolución y calidad de video... no he podido encontrar la forma de poder capturar bien en entorno linux que se vea bien la terminal, si alguien tiene data de que aplicación se podría utilizar con la mayor resulución posible, sino optare por capturar pantallas y mandarle con edición a full para que se visualice lo mejor posible.  

Nota: Espero puedan darme una mano, todo ayuda, consejos críticas serán bien recibidas; un poco frustrado con el tema de instalación de 0, igual arranque con los tutos tanto en texto con imágenes, como en audiovisual en funcionamiento como usuario del mismo, estoy separando en 3 Niveles, 1 Avanzado, 2 Medio y 3 Básico, aplicando la mayor simpleza para su interpretación.

Así también, estoy transcribiendo el audio, del encuentro de Oro Verde, lamentablemente la calidad es pésima, lo estoy trabajando para limpiarlo lo mejor posible, ya que todo lo compartido, considero nos puede ser de mucha utilidad. Si alguien desea sumarse también sería una gran mano. (la idea es luego el texto traducirlo por lo menos a inglés.)

Se sumo mi hermano a la causa, se involucro de pleno, sin saber nada, me esta ayudando mucho, sus conocimientos de estos eran 0 y en cuanto a tecnología cerapio, va aprendiendo bastante rápido.

Rodando todo berenjenal, me percaté que falta una gran pata, la de documentación en todos los formatos posibles, para los que en definitiva son los que utilizarán el sistema, Prof. Salud, etc., las capacitaciones iniciales, las dudas de gente como la de mi pueblo que casi no ha tocado una PC, seguramenete sucede en muchas partes del mundo; por ello estoy poniendo mucho en la simpleza posible y que podamos, no solo tener información de impletación a nivel programación, instalación, sino mucho material para la gente que lo utilizará, para que se les haga lo mas fácil y ameno posible. Esto hoy en mi caso con el hospital es un cuello de botella, quizá por la zona que me encuentro, gracias a Dios le estoy encontrando la forma, todos los que deseen sumarse, en mi humilde opinión "Hay que trabajar mucho en material del uso de Gnu Helath".

Disculpen a todos de sobremanera, mi tan extensa expresión, me encuentro muy cansado, espero del fondo de mi alma, poder haber transmitido lo más claro posible, así también no estoy aún bien de salud y eso juega bastante en contra, pero mi amor por esta causa rompe fronteras.

Fuerte Abrazo Ceci y a toda la comunidad !!! "Mis más sinceras felicitaciones por tu gran y hermoso trabajo", esta muy claro, quizá como comentan hay que tratar de hacer lo más básico posible, en terminologías, ilustrarlo quizá, (me ofrezco claro), ya que tengamos en cuenta, que todos no somos reyes de la programación y la gran meta es que GNU Heath se implemente de la manera más amena y sencilla, desde un Médico que lo desee utilizar, un Centro de Salud, un pequeño hospital u uno con infraestructura en salud grande, ni hablar de interconexión entre ambos, provicialmente u nacionalmente, etc.

Cariños afuctuosos y Bendiciones para todos !!!

Ginito

El 10 de octubre de 2014, 15:16, Maria Cecilia Santos Popper <address@hidden> escribió:

Gente, yo ya estuve metiendo algunas modificaciones en las primeras secciones de la wiki, me gustaría que vayan contando que les parece y si faltaría agregar algo.
Este fin de semana espero poder seguir. ...
Saludos
Cecilia

El 04/10/2014 14:54, "Juan Esteban Carrique" <address@hidden> escribió:

Cuchareo la sopa y sigo con el postre :p

Coincido que lo mejor es profundizar el modelo de documentar desde la wiki, simple y democrático.

Entonces como postre propongo estructurar ( diseñar ) la doc.

De esta forma se utilizaría como máster la wiki y via proceso de transformación se arma un PDF u otro extracto ( se maeteriza para el medio deseado )

Respecto a los tutos también considero que a mediano plazo resulta conveniente diseñarlos/estandarizarlos.

Y la visión a largo plazo entiendo sería que cada lanzamiento resulte orgánico, se actualiza el código y durante el tiempo de testing se actualiza la doc, mejor si fuera en simultaneo.

Dicho todo esto, cuando hacemos un meeting en línea?

:J'u"a.n_  (dde el móvil)

El oct 4, 2014 8:41 a.m., "Ginito Vo" <address@hidden> escribió:

Estimada Amiga,

Dime cuales o pasames que te los paso en el formato que desees, igualmente están muy obsoletos, casi diría utilice el concepto nomas y re escribí todo de nuevo, ya que la ver. 2.6.x cambió bastante la distribución visual, botones y todo lo nuevo.

Por los PDF pasamelos y te los devuelvo en el formato que desees.

Fuerte abrazo! Cariños y bendiciones.

Nota: Recuerda cuando puedas si le parece bien charlamos lo que aún me quedó en el tintero que puede nutrir mucho todo esto. Ya que por aquí es largo para explicar.

Ginito

El 04/10/2014 08:34, "Maria Cecilia Santos Popper" <address@hidden> escribió:

Genial Ginito!

El tema es que mucha de la documentación que me ha llegado está en formato pdf por lo que exportarla a texo tendrá el famoso problema del entrecortado de las líneas...
les parece armar algún drive compartido o algo así para poner todos los archivos que estemos usando y trabajar luego en el wikibooks?

PD: Ya hice algunos cambios y agregué cosas en las secciones 1, 2 y 3 por si quieren ir comentando....

Slds
Ceci

2014-10-04 8:25 GMT-03:00 Ginito Vo <address@hidden>:

Buenos Dias Amigos de la comunidad, Ceci, un gustazo Mauricio.

Como comentas Ceci me parece más que brillante, esta bueno lo de wikibook, su motor hace que sea casi viral, también dejaría la misma info en algún formato para bajar, algunos tutoa son muy largos y a veces se necesitan de ayuda o en el caso de estar capacitando a usuarios nuevos, sirva para entregárselos.

Les comento que fui avenzando, capturando pantallas de la ver. 2.6.x y escribiendo mucho, un genérico no muy especifico, lo tendré en unos días en borrador, se los pasaré a ver que les parece, que agregar, que modificar.

En cuanto a instalación, hice lo mismo con Mint 17 (ubuntu 14.4) y estoy terminando las capturas con Un un tu puro, la idea es seguir con Debían...

Les pido si les llega algo más de información lo que creo que todos ya disponemos, si no es molestia pasarmelos, así puedo ir nutriendo lo hecho.

Luego de la semana de espera, como comentan, charlamos cuantos somos los que nos sumamos y cada uno que  parte toma, para no estar haciendo lo mismo todos.

Según como habíamos confirmado el 20 de sep. eramos solo 3, sería fantástico que se sumen todos lo que lo deseen voluntariamente.

Fuerte abrazo a todos! agradecido por brindarme este espacio para expresarme. Cariños y bendiciones!

Ginito

El 04/10/2014 06:10, "Mauricio Baeza" <address@hidden> escribió:

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/