Estoy buscando recomendaciones para una wiki/base de conocimiento/plataforma adecuada para producir documentación sobre una variedad de proyectos de inteligencia empresarial como:
- Documentación de la base de datos: documentación sobre todos los objetos de la base de datos, documentación técnica interna para el equipo.
- Documentación ETL: documentación detallada sobre procesos ETL, cronogramas, etc. internamente para el equipo.
- Documentación de procedimientos: notas paso a paso sobre la producción de informes, extractos de datos y procesos internos.
- Documentación del informe: documentación de respaldo para los informes existentes, menos técnica para que una audiencia más amplia fuera del equipo la consuma pero no contribuya. En la actualidad, nada de esto existe y la mayoría está en mi cabeza y, aunque me siento más que cómodo usando cualquier pieza de software en particular, otros miembros del equipo no lo están, por lo que la facilidad de uso es fundamental. Estas son las cosas que considero esenciales:
- GUI intuitiva: fácil de entender los conceptos básicos con muy poca capacitación, no requiere ningún conocimiento de HTML/Javascript/CSS para producir un documento
- Editor WYISWYG basado en alguna forma de marcado para producir documentos limpios y consistentes, sin editores de texto enriquecido para que los usuarios creen sus propios estilos.
- Bloques de código/resaltado de sintaxis
- Plantillas: capaz de crear plantillas de página/documento que requieren que se ingresen campos y le indica al usuario qué incluir según el tipo de cosa que esté documentando.
- Integración con Active Directory existente
- Gestión sencilla del flujo de trabajo para marcar páginas como obsoletas o que requieren actualizaciones
- Fácil de incrustar y editar capturas de pantalla/imágenes en las páginas
- Método de agrupación y estructuración de contenidos ya sea a través de etiquetas, macros para facilitar la navegación
Deseable:
- Control de versiones de documentos
- Permisos granulares
- Gestión del flujo de trabajo para la aprobación de contenidos
- Exportar documentos a PDF/Word
Actualmente tenemos SharePoint Online en nuestra organización y espero considerarlo, pero personalmente siento que esto no cumple con los criterios esenciales listos para usar.
Confluence parece ideal, aunque estoy interesado en conocer otras alternativas para compararlo, tal vez XWiki.
eric s