Estoy buscando software para organizar y mantener la documentación interna de los proyectos, las especificaciones, los requisitos, etc. Actualmente almacenamos toda la documentación como muchos archivos MS Word DOC en un repositorio de control de código fuente, lo que nos da control de la versión, y eso es bueno. Pero no puede buscar esta información, crear enlaces entre ellos, clasificar, colaborar.
Requisitos, preferencias:
- Instalación cero en el lado del cliente (basado en WEB).
- Control de versiones de documentos.
- Anotaciones de documentos.
- Enlace de documentos.
- Búsqueda completa (toda la documentación).
- MS Word (* .doc) importación \ exportación.
- Editor de texto WYSIWYG.
Sistemas que he descubierto y probado hasta ahora:
Respuestas:
¿Qué tal algo como Sphinx ?
Usted escribe su documentación en reStructuredText (la sintaxis es similar a Markdown, que utiliza Stack Overflow) en archivos de texto sin formato (= fácil de controlar la versión) y Sphinx escupe páginas HTML.
Los dos usuarios más destacados de Sphinx (que yo sepa) son el lenguaje Python y TortoiseHG (ver los enlaces para la documentación generada por Sphinx).
EDITAR:
Acabo de leer que está hablando de documentación interna del proyecto, no de documentación del usuario final.
En mi opinión, algo así como Sphinx es la mejor manera de documentación interna también (siempre que pueda hacer que sus analistas escriban reStructuredText) porque:
Si Sphinx es demasiado complicado, hay una forma más fácil: puede escribir su documentación en Markdown y usar Pandoc para crear (por ejemplo) archivos .rtf, .doc o .pdf (puede hacer mucho más).
Pandoc me pareció más fácil de comenzar que Sphinx, pero Pandoc no puede crear buenas jerarquías de menú como Sphinx (como en la documentación de Python y TortoiseHG que he vinculado anteriormente).
Independientemente de las herramientas que utilice, si tiene un servidor web interno y un servidor de compilación, puede configurarlo para que el servidor de compilación genere una salida HTML y la copie en el servidor web cada vez que alguien envíe algo a la documentación. Por lo tanto, sus analistas ni siquiera tienen que pensar en el resultado final, solo necesitan comprometerse e impulsar sus cambios.
fuente
Bueno, puedes intentar implementar un Wiki. Mediawiki tiene todas las características faltantes de las que está hablando (funciones de búsqueda, historial de versiones, enlaces, categorización). Tendrá que asegurarse de saber exactamente qué versión de la documentación pertenece a qué versión del software, pero eso se puede hacer mediante la convención de incluir una referencia de versión o una categoría específica en cada artículo dependiente de la versión.
PERO: Usted escribe que tiene "analistas" que no son desarrolladores (lo admito, no soy fanático de esa constelación). Ese tipo de personas a menudo no está contento cuando reemplaza sus herramientas de MS Office por alguna herramienta orientada al texto como un Wiki. Y dado que MS-Word no es software libre, supongo que el requisito de "software libre" no es realmente obligatorio. En esta situación, un servidor Sharepoint podría ser la mejor alternativa. No es gratuito, pero AFAIK tiene todas las características que está solicitando, y los documentos aún se pueden crear con Word, Excel, etc.
fuente
Siempre es mejor mantener las especificaciones y la documentación bajo el control de la versión, ya que le daría la mayor influencia, aunque la curva de aprendizaje sería un poco empinada. En caso de un motor de conocimiento, recomiendo lo siguiente
Ambas tienen interfaces mínimas, son compatibles con la mayoría de las estructuras wiki, son bastante fáciles de implementar y mantener, admiten revisiones, tienen un buen editor WYSIWYG e incluso pueden conservar su documentación y especificaciones. A menos que sus proyectos sean realmente enormes, puede elegir cualquiera de los anteriores.
fuente
Recientemente comenzamos a usar el Alfresco DMS que tiene muchas propiedades interesantes:
También hay algunas desventajas:
Si decide darle un giro, contácteme con sus opiniones.
fuente
Otra posibilidad podría ser usar LaTeX o algún otro formateador de texto (quizás texinfo o incluso lout ) para la documentación. Partes de él pueden ser generadas a máquina. Existen algunas herramientas para la conversión de HTML, como HeVeA para convertir LaTeX a HTML. También puede usar doxygen para generar documentación a partir de comentarios estructurados dentro de su código fuente. Y las partes escritas a mano de la documentación pueden (y deberían) gestionarse como código fuente (por ejemplo, control de versiones y compilación).
fuente
Sugeriría usar una herramienta UML y ERD, además de sus documentos. Además, puede almacenar estos documentos en ZOHO en ZOHO-Docs , que no es gratuito, pero es extremadamente barato y permite la búsqueda de documentos.
Independientemente de la herramienta que utilice, debe organizar el contenido del documento cuidadosamente para poder utilizar la búsqueda de texto y obtener resultados significativos. La organización del contenido del documento junto con la denominación de archivos inteligente y estándar podría ser de gran ayuda.
fuente