Crear Página Wiki

Crea nuevas páginas wiki para documentar conocimiento, procesos y especificaciones técnicas. Las páginas pueden ser documentos de nivel raíz o subpáginas anidadas, soportando organización jerárquica profunda para necesidades de documentación complejas.

Crear una Página Raíz

Las páginas raíz aparecen en el nivel superior de tu árbol wiki.

Desde la Barra Lateral

1. Haz clic en el botón "Crear Página" en la parte superior de la barra lateral
2. El modal de creación se abre
3. Ingresa el título de la página en el campo requerido
4. Opcionalmente añade contenido inicial
5. Haz clic en Crear

Desde Estado Vacío

Cuando el wiki no tiene páginas:

1. Ve el mensaje de estado vacío
2. Haz clic en "Crea tu primera página"
3. Completa el modal de creación
4. Tu primera página está lista

Crear una Subpágina

Las subpáginas se anidan bajo páginas existentes, construyendo documentación jerárquica.

Desde el Árbol de Páginas

1. Pasa el cursor sobre la página padre en el árbol de la barra lateral
2. Aparece un ícono "+" a la derecha
3. Haz clic en el ícono "+"
4. El modal se abre con contexto del padre
5. Ingresa el título de la subpágina
6. Haz clic en Crear

La nueva página se anida bajo el padre en el árbol de navegación.

Contexto del Padre

Al crear una subpágina, el modal muestra:

• Título de la página padre
• Indicador visual del anidamiento
• Confirmación de la jerarquía

Esto ayuda a confirmar que estás creando en la ubicación correcta.

Campos del Modal

Título de Página (Requerido)

Propósito: El nombre que aparece en la navegación y como encabezado de la página.

Pautas:

• Descriptivo y específico
• 3-100 caracteres
• Evita caracteres especiales que puedan causar problemas de URL
• Usa convenciones de nomenclatura consistentes

Buenos ejemplos:

• "Guía de Autenticación de API"
• "Desplegando a Producción"
• "Notas de Retrospectiva Sprint 23"

Evitar:

• Palabras únicas como "Notas" (muy genérico)
• Títulos muy largos (se truncan en navegación)
• Duplicar nombres de páginas existentes

Contenido Inicial (Opcional)

Propósito: Iniciar la página con contenido en lugar de en blanco.

Formato: Texto plano o formato estilo Markdown.

Casos de uso:

• Pegar contenido existente
• Comenzar desde plantilla
• Notas rápidas para expandir después

Si se deja en blanco, la página se crea vacía—puedes añadir contenido en modo edición después de la creación.

Después de la Creación

Navegación Inmediata

Después de hacer clic en Crear:

1. El modal se cierra
2. La nueva página aparece en el árbol
3. El contenido de la página carga en el centro
4. Puedes comenzar a editar inmediatamente

Vista de Página Vacía

Las nuevas páginas sin contenido inicial muestran:

• Título de la página como encabezado
• Área de contenido vacía
• Botón de editar para añadir contenido

Modo Edición

Para añadir contenido después de la creación:

1. Haz clic en "Editar Página" en la barra lateral derecha
2. La página entra en modo edición
3. Añade tu contenido
4. Haz clic en Guardar

Organización de Páginas

Elegir Ubicación

Antes de crear, decide la jerarquía:

Página raíz cuando:

• Categoría principal de documentación
• Referencia independiente
• Página índice o hub

Subpágina cuando:

• Relacionada con página existente
• Parte de tema más grande
• Expansión detallada del padre

Reestructurar Después

Las páginas pueden moverse después de la creación:

• Arrastrar y soltar en el árbol (si está habilitado)
• Editar página para cambiar padre
• Crear nueva página y copiar contenido

Consideraciones de Profundidad

Aunque el anidamiento ilimitado está soportado:

• 2-3 niveles es típicamente suficiente
• El anidamiento profundo hace la navegación más difícil
• Usa enlaces cruzados en lugar de árboles profundos

Plantillas

Crear Páginas de Plantilla

Configura plantillas reutilizables:

1. Crea página llamada "[Plantilla] Notas de Reunión"
2. Añade estructura con marcadores de posición
3. Cuando se necesite, copia contenido de la plantilla a nueva página

Sugerencias de Plantillas

Notas de Reunión:

## Fecha: [FECHA]
## Asistentes: 
- 

## Agenda
1. 

## Discusión

## Decisiones Tomadas

## Elementos de Acción
- [ ] 

## Próxima Reunión:

Especificación Técnica:

## Resumen

## Declaración del Problema

## Solución Propuesta

## Diseño Técnico

## Cambios de API

## Cambios de Base de Datos

## Estrategia de Pruebas

## Plan de Despliegue

Runbook:

## Propósito

## Prerrequisitos

## Pasos
1. 
2. 
3. 

## Verificación

## Rollback

## Escalación

Mejores Prácticas

Nombra Consistentemente

Establece convenciones del equipo:

• "Cómo..." para guías
• "[Componente] Arquitectura" para docs técnicos
• "AAAA-MM-DD Reunión" para notas

Comienza con Estructura

Incluso con contenido inicial vacío:

• Planifica tus encabezados
• Sabe qué secciones se necesitan
• Crea el esquema primero

Enlaza al Crear

Después de crear:

• Enlaza desde páginas relacionadas
• Añade a páginas índice
• Referencia en tareas relevantes

Establece Propiedad

Cada página debe tener un propietario:

• Responsable de actualizaciones
• Responde preguntas
• Revisa periódicamente

Permisos

La creación de páginas requiere permisos apropiados:

La configuración del proyecto puede restringir más la creación.

Solución de Problemas

Botón crear deshabilitado:

• El campo de título puede estar vacío
• Verifica campos requeridos
• Verifica permisos

La página no aparece en el árbol:

• El árbol puede necesitar actualización
• Busca errores de creación
• Intenta navegar fuera y volver

No puedo crear subpágina:

• La página padre debe ser válida
• Verifica permisos
• Asegura que el padre no esté archivado

Error de título ya existe:

• Los nombres de página deben ser únicos dentro del proyecto
• Añade especificidad al título
• Busca página similar existente

Atajos de Teclado

Historial de Revisiones del Wiki

Cada página wiki mantiene un historial de versiones completo. Cada guardado crea una revisión, permitiéndote ver versiones pasadas, comparar cambios, entender quién modificó qué, y restaurar contenido previo si es necesario.

Entendiendo las Revisiones

Qué Es una Revisión

Una revisión es una instantánea guardada de una página en un momento específico:

• Contenido: Texto completo de la página al momento de guardar
• Título: Título de la página (si cambió)
• Autor: Quién hizo el cambio
• Marca de tiempo: Cuándo se guardó
• Número de revisión: Identificador secuencial

Cuándo se Crean Revisiones

Nueva revisión creada cuando:

• Página creada por primera vez (revisión 1)
• Modo edición guardado con cambios
• Restauración desde versión anterior
• Operaciones de importación o actualización masiva

Retención de Revisiones

Todas las revisiones se preservan indefinidamente:

• Sin purga automática
• Rastro de auditoría completo
• Almacenamiento optimizado para texto

Acceder al Historial de Revisiones

Desde la Vista de Página

1. Selecciona una página wiki
2. Mira en la barra lateral derecha
3. Encuentra el botón "Historial de Revisiones"
4. Muestra conteo de revisiones (ej., "Historial de Revisiones (12)")
5. Haz clic para abrir el modal

Modal de Revisiones

El modal muestra:

• Lista de todas las revisiones
• Más reciente primero (orden descendente)
• Cada entrada muestra: fecha, autor, resumen
• Navegación para listas largas

Lista de Revisiones

Información de la Entrada

Cada revisión muestra:

Identificar Cambios

Las revisiones pueden indicar:

• "Página creada" para primera revisión
• "Contenido actualizado" para ediciones
• "Título cambiado" si el título se modificó
• "Restaurada desde revisión X" para restauraciones

Ver una Revisión

Vista Previa del Contenido

1. Haz clic en cualquier revisión en la lista
2. El panel de vista previa muestra el contenido
3. Vista de solo lectura de esa versión
4. Contenido completo de la página mostrado

Comparar con Actual

La vista previa indica claramente:

• Este es contenido histórico
• La versión actual puede diferir
• Opción de restaurar disponible

Comparar Revisiones

Abrir Vista de Diferencias

1. En el modal de revisiones, selecciona primera revisión
2. Mantén Ctrl/Cmd y selecciona segunda revisión
3. Haz clic en el botón "Comparar"
4. Se abre el modal de diferencias

Entendiendo las Diferencias

La comparación muestra:

Contenido añadido: Resaltado en verde Contenido eliminado: Resaltado en rojo Sin cambios: Visualización normal

Vista Línea por Línea

Las diferencias muestran cambios contextualmente:

• Líneas añadidas marcadas con +
• Líneas eliminadas marcadas con -
• Contexto circundante para claridad

Diferencias a Nivel de Carácter

Dentro de líneas cambiadas:

• Cambios específicos de palabras resaltados
• Seguimiento de modificaciones detalladas
• Más fácil detectar ediciones pequeñas

Restaurar Revisiones

Cuándo Restaurar

La restauración es útil cuando:

• Eliminación accidental de contenido
• La versión anterior era mejor
• Deshacer cambios de otra persona
• Recuperarse de errores

Proceso de Restauración

1. Abre el historial de revisiones
2. Selecciona la revisión deseada
3. Vista previa para confirmar versión correcta
4. Haz clic en el botón "Restaurar"
5. Confirma la restauración

Después de la Restauración

• Contenido de la página reemplazado con versión antigua
• Nueva revisión creada (restauración registrada)
• Versiones originales preservadas
• Autor de la restauración registrado

La Restauración es Reversible

La restauración crea una nueva revisión, así que:

• Puedes restaurar de nuevo
• Nada se pierde permanentemente
• Rastro de auditoría completo mantenido

Auditar Cambios

Quién Cambió Qué

El historial de revisiones responde:

• ¿Quién editó esta página por última vez?
• ¿Cuándo apareció contenido específico?
• ¿Cómo se veía antes?
• ¿Cómo ha evolucionado?

Uso de Cumplimiento

Para entornos regulados:

• Historial de cambios completo
• Responsabilidad del autor
• Verificación de marca de tiempo
• Sin historial eliminado

Responsabilidad del Equipo

Las revisiones ayudan con:

• Entrenar nuevos editores
• Revisar contribuciones
• Entender evolución de documentación
• Resolver ediciones conflictivas

Mejores Prácticas

Guardados Significativos

No guardes cambios vacíos o triviales:

• Completa unidades lógicas de trabajo
• Evita commits de "arreglar typo"
• Agrupa cambios relacionados

Checkpoints Regulares

Para sesiones de edición largas:

• Guarda periódicamente
• Cada guardado es un punto de recuperación
• Mejor tener revisiones extra

Revisa Antes de Restaurar

Antes de restaurar contenido antiguo:

• Vista previa de la revisión
• Verifica qué podría perderse
• Considera copiar-pegar en su lugar
• Documenta por qué restauras

Limpia a Través de Edición

En lugar de restaurar versiones antiguas:

• Edita la versión actual para arreglar
• Mantén mejoras acumuladas
• Rollback selectivo cuando sea necesario

Limitaciones

Sin Restauración Parcial

La restauración reemplaza la página completa:

• No puedes restaurar un solo párrafo
• Copia-pega para recuperación parcial
• Merge manual si es necesario

No Eliminar Revisiones

Las revisiones individuales no pueden eliminarse:

• Historial completo preservado
• Por diseño para propósitos de auditoría
• Contacta soporte para casos extremos

Revisiones Grandes

Páginas muy grandes pueden:

• Tomar más tiempo para hacer diff
• Tener vistas previas truncadas
• Aún funcionar correctamente

Escenarios Comunes

Eliminación Accidental de Contenido

1. Nota que falta contenido
2. Abre historial de revisiones
3. Encuentra última revisión con el contenido
4. Vista previa para confirmar
5. Restaura o copia-pega

Edición No Deseada por Miembro del Equipo

1. Ve un cambio con el que no estás de acuerdo
2. Abre historial de revisiones
3. Encuentra revisión pre-cambio
4. Discute con el equipo primero
5. Restaura si se acuerda

Entender la Evolución

1. Nuevo en el documento
2. Abre historial de revisiones
3. Navega a través de las versiones
4. Entiende cómo evolucionaron las decisiones
5. Obtén contexto del estado actual

Resolución de Conflicto de Merge

Cuando dos personas editaron:

1. Ve contenido inesperado
2. Compara revisiones recientes
3. Identifica ambas contribuciones
4. Merge manual lo mejor de ambos
5. Guarda versión combinada

Solución de Problemas

No se muestran revisiones:

• Página nueva tiene solo una revisión
• Verifica permisos para ver historial
• Intenta actualizar el modal

Diff no funciona:

• Selecciona exactamente dos revisiones
• Verifica compatibilidad del navegador
• Páginas muy grandes pueden causar timeout

La restauración falla:

• Verifica permisos de edición
• Verifica que la página no esté bloqueada
• Problemas de red pueden interrumpir

La revisión antigua se ve mal:

• El formato cambia con el tiempo
• El contenido es preciso
• El renderizado puede diferir

Permisos

El acceso a revisiones sigue los permisos de la página:

Algunos entornos pueden restringir el acceso al historial.