OT: AYUDA - Proyecto de documentación

farrucu · Mensaje por **farrucu** » Mié, 12 Abr 2006, 11:10

Hola a tod@s.

A ver si puedo explicarlo en palabras breves: Voy a tener que pasarme un montón de tiempo documentando procesos y procedimientos.

He pensado que tal vez exista alguna herramienta informática que facilite la tarea, que podría describirse como un "Documentation Manager Tool", si es que existe algo así, que no lo sé.

Esta herramienta ideal debería permitir de una forma sencilla crear documentos basados en un template, editarlos rápidamente, guardar un track de los cambios, linkar un documento a otro teniendo en cuenta relaciones y dependencias...

El formato no me importa, siempre que no sea propietario: Si generase código HTML, RTF, PDF, HLP o algo similar estaría bien. No necesito muchas mariconadas, pero debe permitir texto con cierto grado de formato (RTF es suficiente) e inclusión de imágenes, que serían principalmente capturas de pantalla. La repera sería ya que puedas cambiar el formato maestro y aplique los cambios a todos los documentos generados.

Bueno, yo no he trabajado nunca con nada parecido, pero estoy convencido de que algo así ha de existir. Por eso recurro a vosotros (realmente estoy preguntando a todos los conocidos), tal vez hayais utilizado algo similar a lo que busco y me podais orientar sobre qué productos pueden adaptarse a todos o muchos de estos criterios.

Gracias.

Mensaje por **Alan78** » Jue, 13 Abr 2006, 04:57

No se si he entendido bien tu necesidad, pero ¿tu lo que buscas no sera un generador de "tickets" verdad?. Me explico, los tipicos sistemas de "yo tengo un problema y lo envio" y luego el administrador responde "se ha hecho tal cosa", quedando todo esto guardado por usuarios, indicencias, seguimientos, notificaciones con sus respectivos numeros y to el tinglao. ¿Es eso a lo que te refieres?

farrucu · Mensaje por **farrucu** » Jue, 13 Abr 2006, 10:19

No, Alan. El sistema de tickets ya lo tenemos implementado desde hace mucho tiempo

Lo que necesito es una herramienta que me permita de forma fácil producir un número de documentos que comparten una misma estructura y poder linkarlos unos a otros. Lo que necesito en última instancia es documentar procedimientos, no reportar problemas ni asignar órdenes de trabajo. Un ejemplo del tipo de cosa que necesito podría ser más o menos así:

PROC. 1185 - "Cómo freir patatas"
==========================

RECURSOS:
Patatas, cuchillo, sartén, aceite, sal

RESTRICCIONES:
No meter las manos en el aceite hirviendo.
No ejecutar después de cenar.
No iniciar si el PROC. 785 - "Pedir comida a domicilio" está en ejecución.

TIEMPO DE EJECUCIÓN:
Unos 30 minutos

PROCEDIMIENTO:
Se pelan las patatas, se descartan las mondas, se trocean las patatas y se echan a una sartén con aceite hirviendo. Sacarlas cuando estén listas y ponerlas en un plato.

[Por el medio varias capturas de la tele donde se ve a Arguiñano pelando, troceando y friendo patatas para facilitar la asimilación didáctica del procedimiento]

DOCUMENTOS RELACIONADOS:
PROC. 0985 - "Cómo pelar patatas"
PROC. 1027 - "Cómo trocear patatas"
PROC. 1061 - "Cómo determinar el tiempo de cocción"

Por supuesto, el número de documentos es grande, los procesos son algo más elaborados que una fritanga patatera, y las interdependencias son profusas e impredecibles, por lo que habría que editar continuamente los documentos. Mi esperanza es que haya una herramienta que facilite esta tarea, porque si lo tengo que hacer a pinrel voy jodido.

Mensaje por **Tropic** » Jue, 13 Abr 2006, 10:57

Cuando termines el procedimiento de las patatas pasamelo, que es muy bueno

Yo como soft de documentacion conozco el wiki, pero no creo que sea tan complejo ni completo...

La gente con la inicie un proyectillo de redes libres hace tiempo queria generar la documentacion con "cvs" y "dockbook", pero no lo he visto ni catado ni instalado, asi que solo te lo pongo como referencia

farrucu · Mensaje por **farrucu** » Jue, 13 Abr 2006, 11:36

Tropic escribió:Cuando termines el procedimiento de las patatas pasamelo, que es muy bueno

Sólo era un ejemplo para dummies generado en tres minutos, así que dispón de él cuando y como quieras.

Tropic escribió:Yo como soft de documentacion conozco el wiki, pero no creo que sea tan complejo ni completo...

Lo he visto, pero si no lo entiendo mal, el tWiki y similares "wikis" sólo te permiten trasladar el proyecto a su website, y paso del tema, sobre esta documentación, alguien decidió que sería "confidencial"

y no puede salir de la intranet. Incluso aunque sean documentos HTML, estarán en una carpeta compartida de un servidor de ficheros.

Seguiré buscando... Qué rabia, porque lo que pido creo que es bastante sencillo... En fins... puta microinformática, cuando usábamos terminales 3270 en vez de estaciones Windows XP, no pasaban estas cosas.

arbiter · Mensaje por **arbiter** » Vie, 14 Abr 2006, 22:16

CVS tree.

No le des mas vueltas de hoja.