Migración de Documentación de Confluence a GitScrum

Los equipos que usan Confluence junto con herramientas de gestión de proyectos frecuentemente sufren por cambio de contexto y flujos de trabajo desconectados. Las características de documentación integradas de GitScrum te permiten mantener contexto del proyecto, decisiones y conocimiento junto a tus tareas y sprints—eliminando la necesidad de sistemas wiki separados.

Comparación de Documentación

Por Qué Consolidar Documentación

EL PROBLEMA DE HERRAMIENTAS DESCONECTADAS
══════════════════════════════════════════

ESTADO ACTUAL (Muchos Equipos):
─────────────────────────────────────
┌──────────────────────────────────────────────────┐
│                                                  │
│   Jira                 Confluence                │
│   ┌─────────┐         ┌─────────┐               │
│   │ Tareas  │ ← → ?   │ Docs    │               │
│   │ Sprints │   ↕     │ Wiki    │               │
│   │ Backlog │   ?     │ Páginas │               │
│   └─────────┘         └─────────┘               │
│                                                  │
│   Problemas:                                     │
│   • Cambio de contexto entre herramientas       │
│   • Documentación desactualizada                │
│   • Enlaces rotos                                │
│   • Búsqueda no encuentra items relacionados    │
│   • Información duplicada                        │
│   • Costos extra de licencias                   │
│                                                  │
└──────────────────────────────────────────────────┘

ENFOQUE INTEGRADO (GitScrum):
─────────────────────────────────────
┌──────────────────────────────────────────────────┐
│                                                  │
│            GitScrum                              │
│   ┌─────────────────────────────┐               │
│   │ Tareas ←→ Docs ←→ Sprints   │               │
│   │                             │               │
│   │ Todo conectado              │               │
│   │ Búsqueda única              │               │
│   │ Enlaces automáticos         │               │
│   │ Contexto preservado         │               │
│   └─────────────────────────────┘               │
│                                                  │
│   Beneficios:                                    │
│   • Sin cambio de herramientas                  │
│   • Documentación actualizada                   │
│   • Enlaces siempre funcionan                   │
│   • Búsqueda unificada                          │
│   • Fuente única de verdad                      │
│   • Costos reducidos                            │
│                                                  │
└──────────────────────────────────────────────────┘

Estrategia de Migración

ENFOQUE DE MIGRACIÓN DE CONFLUENCE
═══════════════════════════════════

PASO 1: AUDITAR CONTENIDO EXISTENTE
─────────────────────────────────────
Categoriza páginas de Confluence:

Docs de Proyectos Activos:
├── Requerimientos
├── Specs técnicos
├── Decisiones de arquitectura
├── Notas de sprint
└── → MIGRAR a GitScrum

Material de Referencia:
├── Guías how-to
├── Docs de onboarding
├── Estándares del equipo
└── → MIGRAR a GitScrum

Histórico/Archivo:
├── Docs de proyectos viejos
├── Decisiones legacy
├── Proyectos completados
└── → ARCHIVAR o MANTENER en Confluence

Wiki Corporativo:
├── Políticas de RRHH
├── Manual de empresa
├── Recursos cross-team
└── → PUEDE QUEDARSE en Confluence

PASO 2: PRIORIZAR MIGRACIÓN
─────────────────────────────────────
Prioridad 1: Documentación de proyectos activos
Prioridad 2: Referencias frecuentemente accedidas
Prioridad 3: Materiales de onboarding
Prioridad 4: Documentación histórica (opcional)

Qué Migrar

TIPOS DE DOCUMENTACIÓN EN GITSCRUM
══════════════════════════════════

DOCUMENTACIÓN DE PROYECTO:
─────────────────────────────────────
Perfecto para GitScrum:

├── Requisitos de Producto (PRDs)
│   └── Vincular a épica/features
│
├── Documentos de Diseño Técnico
│   └── Vincular a tareas de implementación
│
├── Registros de Decisiones de Arquitectura
│   └── Vincular a cambios relacionados
│
├── Documentación de API
│   └── Vincular a tareas de API
│
├── Notas de Planning de Sprint
│   └── Vincular a sprint
│
├── Notas de Retrospectiva
│   └── Vincular a tareas de mejora
│
└── Notas de Reuniones
    └── Vincular a action items

CONOCIMIENTO DEL EQUIPO:
─────────────────────────────────────
También funciona bien:

├── Estándares de Código
├── Checklists de Revisión
├── Guías de Deployment
├── Runbooks de Troubleshooting
├── Guías de Onboarding
└── Documentos FAQ

Características de Documentación de GitScrum

DOCUMENTACIÓN EN GITSCRUM
═════════════════════════

EDITOR DE TEXTO ENRIQUECIDO:
─────────────────────────────────────
├── Soporte Markdown
├── Bloques de código con syntax highlighting
├── Tablas
├── Imágenes y diagramas
├── Archivos adjuntos
├── Checklists
└── Media embebida

CAPACIDADES DE VINCULACIÓN:
─────────────────────────────────────
├── @mencionar miembros del equipo
├── #vincular a tareas
├── Vincular a épicas
├── Vincular a sprints
├── Referencias cruzadas de docs
└── Backlinks automáticos

ORGANIZACIÓN:
─────────────────────────────────────
├── Docs a nivel de proyecto
├── Docs a nivel de épica
├── Descripciones de tareas
├── Comentarios con contexto
├── Labels para categorización
└── Búsqueda en todo

CONTROL DE ACCESO:
─────────────────────────────────────
├── Permisos basados en proyecto
├── Acceso basado en roles
├── Proyectos públicos/privados
├── Opciones de acceso guest
└── Registro de auditoría

Proceso de Migración

MIGRACIÓN PASO A PASO
═════════════════════

PASO 1: EXPORTAR DESDE CONFLUENCE
─────────────────────────────────────
Opciones:
├── Exportar como HTML (mantiene formato)
├── Exportar como PDF (para archivo)
├── Copiar contenido manualmente (para editar)
└── Usar API (para migración masiva)

PASO 2: PREPARAR CONTENIDO
─────────────────────────────────────
Para cada página:
□ Revisar y actualizar contenido
□ Remover información desactualizada
□ Actualizar enlaces rotos
□ Simplificar si es posible
□ Identificar enlaces a tareas GitScrum

PASO 3: CREAR EN GITSCRUM
─────────────────────────────────────
Para cada documento:
□ Crear en proyecto apropiado
□ Agregar a épica relevante (si aplica)
□ Vincular a tareas relacionadas
□ Aplicar labels
□ Configurar permisos

PASO 4: REDIRECCIONAR Y ARCHIVAR
─────────────────────────────────────
En Confluence:
□ Agregar aviso de redirección en páginas viejas
□ Vincular a nueva ubicación en GitScrum
□ Archivar páginas migradas
□ Actualizar bookmarks/favoritos

Mejores Prácticas

MEJORES PRÁCTICAS DE MIGRACIÓN
══════════════════════════════

REVISIÓN DE CONTENIDO:
─────────────────────────────────────
✓ No migrar contenido desactualizado
✓ Actualizar mientras migras
✓ Remover duplicados
✓ Consolidar páginas relacionadas
✓ Simplificar páginas complejas

ESTRATEGIA DE VINCULACIÓN:
─────────────────────────────────────
✓ Vincular docs a tareas relevantes
✓ Vincular tareas a docs relevantes
✓ Usar nomenclatura consistente
✓ Crear estructura de navegación
✓ Agregar tags/labels

TRANSICIÓN DEL EQUIPO:
─────────────────────────────────────
✓ Anunciar plan de migración
✓ Entrenar equipo en docs de GitScrum
✓ Establecer fecha de corte
✓ Deprecar acceso a Confluence gradualmente
✓ Monitorear adopción

MANTENIMIENTO CONTINUO:
─────────────────────────────────────
✓ Revisar docs trimestralmente
✓ Archivar docs de proyectos completados
✓ Actualizar documentos vivos
✓ Fomentar cultura de documentación
✓ Incluir en Definition of Done

Ahorro de Costos

BENEFICIOS DE CONSOLIDACIÓN
═══════════════════════════

AHORRO EN LICENCIAS:
─────────────────────────────────────
Confluence Cloud:
├── Standard: $6/usuario/mes
├── Premium: $11/usuario/mes
└── 50 usuarios = $300-550/mes ahorrados

GANANCIAS DE PRODUCTIVIDAD:
─────────────────────────────────────
├── Sin cambio de herramientas: ~15 min/día
├── Mejor búsqueda: ~10 min/día ahorrados
├── Auto-vinculación: ~5 min/día ahorrados
└── 50 usuarios × 30 min = 25 hrs/día

FRICCIÓN REDUCIDA:
─────────────────────────────────────
├── Fuente única de verdad
├── Menos "¿dónde está ese doc?"
├── Menos enlaces rotos
├── Mejor onboarding
└── Mejor retención de conocimiento

Mejores Prácticas

1. Auditar antes de migrar - no mover basura
2. Actualizar mientras migras - arreglar contenido desactualizado
3. Vincular docs a tareas - maximizar valor de integración
4. Migrar en fases - no interrumpir el trabajo
5. Entrenar al equipo - asegurar adopción
6. Establecer fecha de corte - evitar mantenimiento paralelo
7. Archivar sistema viejo - mantener acceso read-only temporalmente
8. Revisar regularmente - mantener docs actualizados

Anti-Patrones

✗ Migrar todo sin revisar
✗ No vincular a tareas (perder el punto)
✗ Correr en paralelo indefinidamente
✗ Sin entrenamiento del equipo
✗ Migrar wiki corporativo (caso de uso incorrecto)
✗ Ignorar mantenimiento de docs después de migración

Soluciones Relacionadas

• Mejores Prácticas de Documentación Técnica
• Gestión del Conocimiento para Equipos de Desarrollo
• Reduciendo la Dispersión de Herramientas