Capa de revisión: decisiones y recomendaciones
Revisión Vigente 2026-10-05
El micrositio no es solo un prototipo para recorrer: también es el lugar donde se revisa la propuesta. Para eso, cada página puede llevar marcadores en línea que, al hacer clic, muestran una recomendación del equipo del proyecto o una decisión que otra persona o equipo tiene que tomar. Así la conversación ocurre sobre el contenido, en el lugar exacto donde importa, y no en un documento aparte.
1. Componente: marcador de revisión
1.1 Dos variantes
| Variante | Significa | Quién la crea | Símbolo | Etiqueta visible |
|---|---|---|---|---|
| Recomendación | Una propuesta del equipo del proyecto, con su fundamento | Equipo del proyecto | ✦ estrella de cuatro puntas (eco de la nova) | "Recomendación" |
| Decisión | Algo que otra persona tiene que resolver para seguir | Equipo del proyecto, asignada a quien corresponda | ? signo de pregunta | "Decisión · Equipo de revisión" |
Reglas de diseño:
- Nunca solo color. Cada variante tiene su propio símbolo y su etiqueta de texto. El color sale de tokens de señal de Stella Nova (
--sn-*): uno para recomendación y otro para decisión, sin colores fijos. - El marcador va en línea, junto a la frase, el bloque o la tarjeta a la que se refiere. No interrumpe la lectura: es un botón pequeño del tamaño de la tipografía.
- Cuando una decisión se resuelve, el marcador no desaparece de inmediato: pasa a estado "resuelta" (símbolo con contorno, atenuado) hasta la versión siguiente, para que quede trazabilidad.
1.2 Al hacer clic: la tarjeta
texto de la página … Incrustar documentos ✦ …
┌──────────────────────────────────────────┐
│ ✦ RECOMENDACIÓN R-04 │
│ El PDF va en "documentos" y no en "video, │
│ código y 3D": se comporta como documento. │
│ Fundamento: modelo mental del usuario. │
│ Estado: propuesta · 05-10-2026 │
│ Ver en: Árbol, §5 → │
└──────────────────────────────────────────┘
| Campo | Recomendación | Decisión |
|---|---|---|
| ID | R-nn | D-nn |
| Texto | Qué se propone | Qué hay que decidir, como pregunta cerrada cuando sea posible |
| Fundamento u opciones | Por qué (criterio UX, Diátaxis, dato del inventario) | 2 o 3 opciones, con la recomendada marcada |
| Responsable | Equipo del proyecto | Quién decide (un rol, no una persona: equipo de revisión, equipo del proyecto…) |
| Estado | propuesta · aceptada · descartada | pendiente · a discutir · resuelta · bloqueante |
| Impacto | — | Qué queda bloqueado mientras no se decida (páginas o tareas del Gantt) |
| Fecha | creación | creación y resolución |
| Enlace | al documento de diseño donde se fundamenta | ídem |
1.3 Interacción y accesibilidad
| Aspecto | Comportamiento |
|---|---|
| Elemento | <button> con aria-expanded y aria-controls; la tarjeta es una región con su propio título |
| Abrir | clic o toque, o Enter / Espacio con teclado. No se abre al pasar el mouse por encima (el hover no existe en móvil y un tooltip que se abre solo molesta al leer) |
| Cerrar | Escape, clic fuera o el botón de cierre. El foco vuelve al marcador |
| Móvil | la tarjeta se abre como panel inferior a todo el ancho |
| Varias abiertas | solo una a la vez |
| Lector de pantalla | el botón anuncia "Recomendación R-04" o "Decisión D-02, pendiente, responsable Equipo de revisión" |
1.4 La capa se puede apagar
En la barra del micrositio hay un interruptor: "Mostrar revisión".
| Modo | Para qué | Marcadores |
|---|---|---|
| Revisión (por defecto en la URL de revisión) | Recorrer la propuesta y decidir | visibles |
| Vista final (por defecto en el test con usuarios) | Ver el sitio tal como quedaría en la wiki real y probarlo con alumnos y profesores | ocultos |
Es importante: en el test con usuarios los marcadores no deben verse, porque contaminarían la tarea. El modo se puede fijar por URL (?revision=1 o ?revision=0) para que cada enlace que se comparta abra en el modo correcto.
1.5 Vista agregada: "Decisiones pendientes"
Una página del micrositio reúne todos los marcadores en una tabla filtrable por tipo, responsable y estado, con un enlace al lugar exacto de cada uno. Sirve como agenda de la reunión de revisión y alimenta la carta Gantt: cada decisión bloqueante es una dependencia.
1.6 Cómo se escriben (en el micrositio)
Cada marcador se declara una sola vez, en un registro (data/revision.yml), y en el texto solo se cita su ID. Así la misma decisión puede aparecer en varias páginas sin duplicarse, y la vista agregada se genera automáticamente.
- id: D-01
tipo: decision
responsable: "Equipo de revisión"
estado: pendiente
bloquea: [portada-real, "#ask de ayudas"]
pregunta: ¿Se reconstruyen los datos SMW de Persona y Travesía?
opciones: [rebuildData.php, edición nula por lotes, filtrar siempre por namespace]
recomendada: rebuildData.php
fuente: ARBOL §6 P1
En el contenido: {{rev D-01}}, junto a la frase que corresponde.
2. Registro inicial (14 decisiones · 11 recomendaciones)
Todo lo que hoy está abierto en los documentos de diseño, convertido en marcadores. Cada uno indica dónde aparecería.
Decisiones (D)
| ID | Responsable | Pregunta | Bloquea | Dónde aparece |
|---|---|---|---|---|
| D-01 | Equipo de revisión | ¿Se reconstruyen los datos SMW de Persona y Travesía (P1)? | las vistas con #ask en la wiki real |
Portada (bloque de vistas) · 29 |
| D-02 | Equipo de revisión | ¿Se mueven las 4 páginas mal ubicadas (P2)? | listados por namespace | Portada |
| D-03 | Equipo de revisión | ¿Cuál es la página canónica de privacidad (P3)? | 31 | 31 |
| D-04 | Equipo de revisión | ¿Se corrigen las dobles redirecciones (P4)? | — | 24 · 23 |
| D-05 | Equipo de revisión | ¿Se borra o se reutiliza Documentación:Sandbox de pruebas (P6)? | — | 41 |
| D-06 | Equipo de revisión | ¿Se aprueba el cambio del menú "Wiki" (Ayuda / Empieza aquí) en MediaWiki:Sidebar? |
publicar la nueva entrada | barra del micrositio |
| D-07 | Equipo de revisión | ¿Cuál es el proceso para ser administrador (requisitos y canal)? | F17 y la conversión de 35 | 35 · F17 · 32 |
| D-08 | Equipo de revisión | placeholders y modo Entender en la wiki real | ficha de cualquier página · Documentación:Ayudas por escribir |
|
| D-09 | Equipo del proyecto y de revisión | ficha, portada y recorridos | Portada "¿Quién eres?" · ficha | |
| D-10 | Equipo de revisión | — | C0 | |
| D-11 | Equipo del Archivo Histórico | Criterios de catalogación del Archivo Histórico | F14 | F14 |
| D-12 | Equipo de revisión | ¿Propuesta de separar Stella Nova/Tokens en explicación y referencia? | — | 39 |
| D-13 | Equipo de revisión | ¿Corregir los colores fijos de .card y .wiki-accordion en la hoja /style.css de cada plantilla, y no en Common.css (Fase 8)? |
ejemplo de 39; modo oscuro en Ayuda | 38 · 39 |
| D-14 | Equipo del proyecto | ¿Qué es el widget PiX? | 13 o 42 | 42 |
| D-15 | Equipo del proyecto | — | C0 |
Recomendaciones (R)
| ID | Recomendación | Fundamento | Dónde aparece |
|---|---|---|---|
| R-01 | El nodo es la unidad mínima y el tutorial, la unidad base | Diátaxis: el tutorial es compuesto; lo que se cita para entender es una explicación | Portada · 1 |
| R-02 | El perfil es una pista de entrada, no un filtro | Decisión de junio: segmentar por tarea | Portada |
| R-03 | Separar toda página que sirva a dos fichas | Brújula de Diátaxis | 9 · 21 (los casos más visibles) |
| R-04 | El PDF va en documentos (42), no en 13 | Modelo mental: el PDF se lee como documento | 42 |
| R-05 | El audio (SoundCloud) va dentro de 13, en la sección de video | Mismo comportamiento de reproducción | 13 |
| R-06 | Plantillas, formularios y propiedades: página puerta en lugar de guías | Son funciones de SMW, exclusivas de administradores; evita duplicar la documentación oficial | 35 |
| R-07 | Colores solo con tokens, sin fallback | Modo oscuro, mantención, sanitizador de TemplateStyles | 38 · 41 |
| R-08 | Las fuentes oficiales mandan para los hechos; Casiopea, para el contexto | Exactitud y versión instalada | pie de cualquier página ("Fuentes") |
| R-09 | Mientras F17 esté pendiente, la conversión lleva a Casiopea:Solicitudes | Evitar un callejón sin salida | 35 |
| R-10 | La capa de revisión se apaga en el test con usuarios | No contaminar la tarea | barra del micrositio |
| R-11 | Por ahora, la capa de revisión queda solo en el micrositio | En la wiki real agregaría mantención y exposición de discusiones internas; conviene probarla primero en el micrositio | Decisiones pendientes |
3. ¿Se lleva a la wiki real? → Propuesta P7, para proponer y evaluar
No es una decisión que haya que tomar ahora. Se presenta como propuesta de cambio P7 (igual que P1 a P6), para que se evalúe una vez que la capa haya funcionado en el micrositio.
| Propuesta | Crear Plantilla:Nota de revisión en la wiki real: el mismo marcador (✦ recomendación / ◆ decisión), visible solo para administradores, con un registro centralizado en Casiopea:Administradores/Tareas |
| Para qué serviría | Dejar las decisiones pendientes en el lugar exacto de la página a la que afectan, en vez de en documentos aparte. Dar trazabilidad (quién decidió qué y cuándo) dentro de la propia wiki. Coordinar a los administradores sin salir de Casiopea |
| Qué habría que evaluar | Si la visibilidad por grupo de usuario (solo administradores) es confiable en Stella Nova. Cuánta mantención agrega (marcadores resueltos que hay que limpiar). Si hay discusiones internas que no conviene dejar en el historial público de las páginas. Si Casiopea:Administradores/Tareas ya cubre la necesidad |
| Cuándo evaluarla | Después de la revisión del micrositio, a la luz de cuánto se usó la capa |
| Estado actual | La capa de revisión existe solo en el micrositio (R-11) |