Saltar al contenido
Ayudas Casiopea proyecto · Stella Nova v0.9.0
Tema
Tamaño de letra
Familia
Ver prototipo

Proyecto / Documentos

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 ¿Se aprueban "Pendiente" en Estado y "Explicación" en Tipo de Documento? Resuelta: los dos, aprobados el 9 oct 2026 ("Explicación" reemplaza a "Apunte") 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 Reformular las audiencias Resuelta: Lector, Alumno, Profesor, Administrador y Mantenedor (ver Árbol §4) ficha, portada y recorridos Portada "¿Quién eres?" · ficha
D-10 Equipo de revisión ¿Quién mantiene Con§tel y si tiene documentación oficial? Resuelta: existe el Manual de con§tel y la ficha de la obra declara a sus autores — 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 ¿Se divide el Manual de con§tel o se usa una página puerta? Resuelta: ambas. La puerta (C0) enlaza al manual y cada tema se escribe en su modo (C1 a C17), con verificación manual — 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)