|
| From: | Juan Esteban Carrique |
| Subject: | Re: [Health-es] Proceso de revisión y mejora de documentación en español |
| Date: | Sat, 4 Oct 2014 14:45:49 -0300 |
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)
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ó:SldsPD: Ya hice algunos cambios y agregué cosas en las secciones 1, 2 y 3 por si quieren ir comentando....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?
Ceci2014-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 PopperSanta Fe
(0342) 154 440 615
www.linkedin.com/in/ceciliasp/
--Lic. Cecilia Santos Popper
| [Prev in Thread] | Current Thread | [Next in Thread] |