Inventario y propuesta de ficha

Este documento complementa la Especificación del micrositio: aquí está la base existente, y en el SPEC, el destino. Los números entre corchetes, como [#9], remiten al catálogo del SPEC.

---

1. Resumen

Hallazgos que condicionan la propuesta

1. La categoría de documentación está contaminada. Categoría:Documentación Casiopea devuelve 361 páginas, pero solo unas 25 son documentación. Hay unas 310 páginas Persona y 22 Travesía registradas como "Referencia · Editor general". Revisé Plantilla:Persona y Plantilla:Travesía: hoy tienen la ficha dentro de <noinclude>, que es lo correcto. Lo más probable es que sean datos semánticos guardados antes de esa corrección, que SMW todavía no actualiza. Consecuencia: cualquier #ask sobre esa categoría (portada de ayudas, índice por modo) mostraría cientos de personas. Hay que resolver esto antes de construir las vistas. La solución sería rebuildData.php o una edición nula de esas páginas, una tarea de administración que debe coordinarse con el equipo de revisión. Otra opción es filtrar siempre por Tipo de Documento::+ más el namespace.
2. El tipo declarado no coincide con lo que la página hace. Las páginas más importantes mezclan dos o tres modos de Diátaxis. Por ejemplo, Guía de Edición de Contenidos Textuales (275 líneas) mezcla pasos y sintaxis; Creación de páginas está tipada como Referencia pero contiene pasos; Nuevo Usuario está tipada como Tutorial pero es un hub.
3. Falta el modo Entender casi por completo. Las explicaciones están dispersas en páginas de gobernanza (Casiopea:Modelo semántico, Categorías y vocabulario) escritas para editores, y en páginas de 2010.
4. Los roles y permisos están fragmentados en 9 páginas, con duplicados (Autoconfirmados / Usuarios autoconfirmados) y sin una vista única para un administrador nuevo.
5. La privacidad está en 6 páginas superpuestas (Política de privacidad, Política de protección de datos, Normativa de privacidad, Aportes y datos personales, Cumplimiento, Solicitudes sobre datos personales). No es ayuda, pero las ayudas deben enlazar a una sola.
6. Las Palabras Clave no se leen en la consulta: la columna vino vacía en las 361 filas. Hay que verificar si se guardan como propiedad o solo como categoría (los valores Ayuda/Edición tienen forma de categoría).

---

2. Inventario clasificado

Columnas: Tipo actual (lo que dice la ficha) · Modo real (lo que la página hace, según Diátaxis) · Acción · Destino. Abreviaturas de modo: Ap = Aprender (tutorial), Re = Resolver (cómo hacer), Co = Consultar (referencia), En = Entender (explicación), Hub = punto de entrada.

2.1 Espacio Ayuda:

2.2 Espacio Casiopea: (gobernanza, roles y modelo)

2.3 Espacio principal

2.4 Plantillas (87 en Categoría:Plantillas)

Cada plantilla documentada (Persona, Travesía, Curso, Tarea, Botón, Tarjeta, Aviso, Acordeón, Tooltip…) es, por naturaleza, una referencia de objeto (modo Co). No se reescriben. La propuesta es:

• Agruparlas en [#23] Plantillas de interfaz (Botón, Tarjeta, Tarjeta XL, Aviso, Nota, Acordeón y sus variantes, Tooltip, Imagen, Imágenes, Contenido Relacionado, En construcción) y en [#20] Campos de cada formulario (las de objeto: Persona, Tarea, Curso, Asignatura, Clase, Proyecto, Obra, Travesía…).
• Darles la misma ficha v0.4 en su variante "Referencia de objeto" (§3.3).

---

3. Propuesta de ficha (v0.4)

3.1 Principio

La ficha actual describe el documento (tipo, estado, mantenedor). La nueva ficha orienta al lector: en dos segundos debe saber qué modo de texto tiene delante, si es para su perfil, qué gana y qué debe leer antes o después. Los datos de gobernanza se mantienen, pero bajan de jerarquía.

Se conservan las 12 propiedades y el parámetro Mostrar Ficha. Se agregan tres parámetros: Tiempo, Siguiente y Puentes. "Modo" no se escribe: se deriva de Tipo de Documento, para evitar un dato duplicado que pueda contradecir al tipo.

3.2 Estructura de la ficha en tres capas

┌───────────────────────────────────────────────────────────────┐
│ [RESOLVER]  Para qué te sirve: Tendrás tu cuenta lista.       │  1. ORIENTACIÓN
│ Para: Alumno · Profesor     Principiante · 5 min              │     (siempre visible)
├───────────────────────────────────────────────────────────────┤
│ Antes: Primeros pasos  →  Después: Crea tu Persona            │  2. RUTA
│ En otros modos: Consultar: Roles · Entender: Persona y Usuario│     (visible, compacta)
├───────────────────────────────────────────────────────────────┤
│ ▸ Sobre este documento                                        │  3. GOBERNANZA
│   Vigente · revisado 2026-10 · Mantiene: equipo de la wiki   │     (plegada, <details>)
│   Documenta: Especial:Crear cuenta · Palabras clave: Cuenta   │
└───────────────────────────────────────────────────────────────┘

Comportamiento: en escritorio la ficha es una banda horizontal bajo el título; en móvil, las capas 1 y 2 se apilan y la 3 queda plegada. La capa 2 se repite al pie como navegación "Antes / Después / En otros modos", para que al terminar de leer no haya que volver arriba.

3.3 Variantes de la ficha

---

4. Distribución de la información dentro de cada página, por modo

La prueba de Diátaxis para clasificar: ¿la página sirve para actuar o para saber? ¿Se lee mientras se estudia o mientras se trabaja?

Si una página responde a dos casillas, se divide. Ese es el criterio que justifica las divisiones del inventario.

4.1 Aprender (tutorial)

1. Ficha
2. Qué vas a lograr: el resultado final, con una imagen o animación de cómo se verá.
3. Antes de empezar: una lista breve (cuenta activa, sesión iniciada).
4. Pasos (componente Ruta): cada paso tiene una acción, un resultado visible ("Verás…") y, si hace falta, un Más detalle plegado. No se ofrecen alternativas: un solo camino.
5. Lo lograste: cómo comprobar el resultado (por ejemplo, "Tu Persona aparece en…").
6. Sigue con: el paso siguiente (campo Siguiente).
7. Puentes: "Si quieres entender por qué…" (Entender) · "Cuando lo hagas de nuevo…" (Resolver).

Regla: el tutorial no explica la teoría ni enumera opciones. Lo que se sale del camino se enlaza.

4.2 Resolver (cómo hacer)

1. Ficha
2. Cuándo usar esta guía: una línea que describe la situación.
3. Requisitos
4. Pasos numerados: directos, en imperativo.
5. Variantes: un Más detalle por caso, o un Aviso por perfil ("Si eres profesor…").
6. Si algo falla: problemas frecuentes, cada uno con su solución.
7. Puentes: Consultar ("todos los campos") · Entender ("por qué se pide").

Regla: se parte de una tarea real, no de una función de la herramienta. El título empieza con un verbo.

4.3 Consultar (referencia)

1. Ficha
2. Resumen en una línea: qué contiene la página.
3. Cuerpo estructurado: tablas o listas con un ancla por ítem, para poder enlazar directo a un campo o a una plantilla. Mismo orden que la interfaz real.
4. Notas y excepciones
5. Ver también

Regla: sin narrativa ni pasos. Debe ser completa y exacta. Se usa con Ctrl+F.

4.4 Entender (explicación)

1. Ficha
2. La idea en una frase
3. Desarrollo: el porqué, el contexto y la historia (por ejemplo, la Escuela y la wiki como bitácora colectiva).
4. Un ejemplo en la wiki real: un enlace a una página existente que lo muestre.
5. Confusiones frecuentes: por ejemplo, Persona frente a Usuario.
6. Para ponerlo en práctica: puentes a Aprender y Resolver.

Regla: aquí sí caben matices y opiniones fundadas. No hay pasos.

4.5 Componentes por modo

● habitual · ○ ocasional · — no corresponde

---

5. Ajustes al catálogo del SPEC a partir del inventario

• Se agregan [#32] Roles y permisos (Consultar; Admin, Profesor) y [#33] Cambiar tu nombre de usuario (Resolver; Alumno, Profesor). El catálogo queda en 33 páginas más la portada.
• [#31] Autoría, licencias y derechos enlaza a una página de privacidad canónica. Cuál es la canónica queda por decidir (D-03).
• Las vistas automáticas se filtran por namespace (Ayuda: y Documentación:) más Tipo de Documento::+, para no arrastrar las 330 páginas contaminadas.

6. Estado de las decisiones (actualizado el 5 oct 2026)