Wiki.js es una plataforma de documentación colaborativa y moderna. Permite crear, organizar y compartir documentación técnica de manera estructurada, con soporte para:
- Edición en Markdown — Escribe documentación con sintaxis estándar, sin depender de editores propietarios.
- Control de acceso — Permisos por usuario, grupo o sección. Cada área puede tener su propio nivel de visibilidad.
- Búsqueda integrada — Encuentra cualquier artículo al instante con el motor de búsqueda interno.
- Organización jerárquica — Estructura el contenido en carpetas, categorías y páginas anidadas.
- Historial de versiones — Cada cambio queda registrado. Puedes revisar o revertir ediciones anteriores.
- Acceso centralizado — Un solo punto de consulta para todos los equipos, sin depender de archivos dispersos en correos o drives.
Históricamente, la documentación de los sistemas SCISA ha vivido dispersa: correos electrónicos, carpetas locales, documentos de Word sin versionar, o directamente en la cabeza de quien desarrolló el sistema.
Este portal resuelve ese problema. Todo el conocimiento relevante para operar, mantener y evolucionar nuestros sistemas vive aquí, versionado, accesible y colaborativo.
Guías paso a paso para el uso correcto de cada sistema o módulo desarrollado por el Equipo de Innovación. Los manuales están estructurados bajo el estándar IEEE 1063 / ISO/IEC/IEEE 26514:2022 e incluyen:
- Descripción general del sistema
- Requisitos previos y acceso
- Flujos de uso principales
- Capturas de pantalla y ejemplos
- Sección de preguntas frecuentes (FAQ)
- Guía de resolución de problemas (Troubleshooting)
- Glosario de términos
- Decisiones de arquitectura (ADRs)
- Diagramas de infraestructura y flujos de datos
- Estándares de código y buenas prácticas
- Guías de configuración de entornos
- Flujos de trabajo del equipo (Git, CI/CD, revisiones)
- Plantillas y templates oficiales
- Guías de documentación BDD / Gherkin
SCISA Wiki
+-- Home
+-- Cliente
¦ +-- Producto
¦ ¦ +-- Manuales de Usuario
¦ +-- Producto
¦ +-- Manuales de Usuario
+-- Miscelánea
Cualquier miembro del Equipo de Innovación puede proponer o mejorar documentación. Para mantener la calidad del contenido, seguimos estas reglas:
- Usa WYSIWYG o Markdown — Toda la documentación se escribe de manera sencilla.
- Sigue las plantillas — Antes de crear una nueva página, revisa si existe una plantilla oficial.
- Versiona tus cambios — Describe brevemente qué modificaste al guardar una página.
- No dejes borradores incompletos — Si una sección aún no está lista, usa el bloque de advertencia
> En construcción.
- Coordina con el equipo — Para cambios estructurales (nuevas secciones, reorganización), abre primero un ticket en ClickUp.
¿Encontraste un error en la documentación? ¿Falta algo importante?
Cominicate con el correo: soporte@scisa.com.mx