Ayudas que faltan

Este documento agrega al sistema de ayudas tres piezas:

1. un placeholder para cada ayuda que falta;
2. un listado que las reúne;
3. la especificación de cada una.

Las 38 páginas del árbol se redactan completas. Lo que aparece aquí es lo que todavía falta para que la wiki esté completa, y queda visible como pendiente en lugar de quedar como enlace roto.

---

1. Cómo funciona

1.1 Placeholder: la página pendiente

Cada ayuda faltante existe como página, con su ficha y su especificación visible, pero sin cuerpo.

┌─────────────────────────────────────────────────────────────┐
│ [PENDIENTE] [RESOLVER]  Documenta una travesía              │
│ Para: Alumno · Profesor                                     │
├─────────────────────────────────────────────────────────────┤
│ ⓘ Esta ayuda todavía no está escrita.                       │
│   Mientras tanto: Documentación:Campos de cada formulario   │
│   #travesía · Plantilla:Travesía · un ejemplo real          │
├─────────────────────────────────────────────────────────────┤
│ ▸ Especificación (lo que debe resolver esta página)         │
│   Problema · Para quién · Criterio de éxito · Fuentes ·     │
│   Antes / Después · Prioridad                               │
└─────────────────────────────────────────────────────────────┘

1.2 Cambio en la ficha

Se agrega el valor Pendiente a la propiedad Estado, que hoy admite Vigente, En revisión y Obsoleto. Es un valor nuevo de una propiedad existente, no una propiedad nueva, igual que "Explicación" en Tipo de Documento.

1.3 Listado: dónde se muestran las pendientes

En la wiki real, el listado se genera con una consulta, de modo que nadie tiene que mantenerlo a mano:

{{#ask: Categoría:Documentación Casiopea Estado::Pendiente Tipo de Documento::+
 | ?Tipo de Documento=Modo | ?Audiencia=Para | ?Prioridad | ?Subtítulo=Problema
 | sort=Prioridad | format=table }}

En el micrositio, el listado se genera a partir del frontmatter de las páginas con estado: pendiente.

1.4 Con qué se llena: documentación oficial

El contenido de cada página se basa en la documentación oficial de cada programa, adaptada a Casiopea. Rige para todas las páginas, y sobre todo para los tutoriales.

Versiones a respetar (siteinfo del 5 oct 2026): MediaWiki 1.43.6 · Semantic MediaWiki 6.0.1 · Page Forms 6.0.5 · Semantic Result Formats 5.2.0 · Maps 12.1.4 · Widgets 1.6.0 · TemplateStyles · Stella Nova 0.9.0.

Reglas:

1. Adaptar, no copiar. Se reescribe en español neutro, con ejemplos de Casiopea, y la página cita su fuente en una sección "Fuentes" al pie (enlace + versión). Si se copia un fragmento literal, se respeta la licencia de origen y se atribuye.
2. La versión manda. Si la documentación describe una función que no existe en la versión instalada, o que Casiopea tiene desactivada, se omite. Ante la duda, se verifica en la wiki real.
3. Los tutoriales se apoyan en los tutoriales oficiales (por ejemplo, el Help:Editing de MediaWiki o las consultas paso a paso de SMW), pero el recorrido usa un objeto de Casiopea de principio a fin: una Persona, una Tarea, una Travesía.
4. Lo que es propio de Casiopea (formularios, plantillas, convenciones de nombre) se basa en las páginas actuales de la wiki y en la documentación de cada plantilla, nunca en la documentación genérica.
5. Esto también resuelve Ayuda:Manual: lo genérico de SMW se reemplaza por enlaces a la fuente oficial, y solo se escribe lo propio de Casiopea.

---

2. Listado de ayudas que faltan

Criterios con que se detectaron:

• Objetos sin tutorial. La ontología tiene unos 20 formularios, pero el árbol solo enseña Persona, Tarea y Curso. Según la regla de la unidad base, cada objeto principal necesita su tutorial.
• Funciones de Stella Nova sin ayuda. La skin trae preferencias de lectura, vista de impresión y la integración con Con§tel, y ninguna está explicada para el usuario.
• Lectores sin cuenta. Ninguna ayuda está pensada para quien solo lee. Esto alimenta el tema pendiente de las audiencias.
• Mantención del propio sistema. No hay ninguna ayuda sobre cómo documentar.

Con estas, el sistema completo tendría 56 nodos: 38 redactados y 18 pendientes. Por modo: Aprender 5 + 5, Resolver 17 + 11, Consultar 9 + 0, Entender 7 + 2.

---

3. Especificaciones

Formato de cada especificación: Problema (qué no puede hacer hoy el usuario) · Criterio de éxito (cómo sabemos que la página funciona) · Antes / Después (ruta) · Mientras tanto (lo que muestra el placeholder) · Fuentes (Casiopea) (contexto local) · Documentación oficial (base factual, según §1.4).

F1 · Documenta tu proyecto de título

• Problema: hay unas 210 titulaciones documentadas, pero no existe un recorrido que enseñe a crear y mantener una carpeta de título. Cada alumno aprende copiando la de otro.
• Criterio de éxito: un alumno crea su página de proyecto de título con formulario, la enlaza a su Persona y a su profesor guía, y aparece en la consulta de la portada (Tipo de Proyecto::Proyecto de Titulación).
• Antes / Después: 2 Crea tu página de Persona → 12 Insertar imágenes y galerías.
• Mientras tanto: 8 Crear una página con formulario · Plantilla:Proyecto · Plantilla:Mis Carpetas de Título.
• Fuentes (Casiopea): Plantilla:Proyecto, Formulario:Nuevo Proyecto, Casiopea:Modelo semántico, consultas de la portada.
• Documentación oficial: MediaWiki Help:Editing · Page Forms (uso de formularios) · SMW Help:Inline queries.

F2 · Documenta una travesía

• Problema: la travesía es un objeto central y patrimonial de la Escuela (22 travesías con ficha), con muchos campos (destino, fechas, obras, alumnos, profesores, mapa). No hay guía y es fácil dejar datos incompletos.
• Criterio de éxito: se crea una travesía con mapa, participantes y obras enlazados, y aparece en Plantilla:Listado de Travesías.
• Antes / Después: 2 → F5 Documenta una obra.
• Mientras tanto: 20 Campos de cada formulario #travesía · Plantilla:Travesía · un ejemplo real.
• Fuentes (Casiopea): Plantilla:Travesía (documentación del 18 jun 2026), Formulario:Nueva Travesía, Maps.
• Documentación oficial: Page Forms · Extension:Maps (coordenadas y mapas) · SMW Help:Properties and types.

F3 · Buscar y navegar en Casiopea

• Problema: nadie le enseña a un lector, con o sin cuenta, a encontrar un proyecto, un curso o una persona: búsqueda, categorías, menú Escuela, Personas y Publicaciones. Es el perfil más numeroso y no tiene ninguna ayuda.
• Criterio de éxito: en el test, un usuario encuentra un proyecto de título de un año dado en 3 pasos o menos.
• Antes / Después: ninguno → 27 Qué es Casiopea.
• Mientras tanto: Portada Casiopea · Categoría:Proyecto · Personas.
• Fuentes (Casiopea): MediaWiki:Sidebar, portada Casiopea, buscador de Stella Nova.
• Documentación oficial: MediaWiki Help:Searching · Help:Categories · Help:Navigation.

F4 · Documentar una plantilla o una ayuda

• Problema: el sistema de ayudas depende de que cada página tenga una ficha correcta (Tipo, Audiencia, Estado, Prerequisitos, Puentes). Sin esta guía, las ayudas nuevas rompen la arquitectura y vuelve el desorden actual.
• Criterio de éxito: un mantenedor crea una ayuda con Formulario:Nueva Documentación de Casiopea, elige bien el modo y la ayuda aparece en la vista correcta de la portada.
• Antes / Después: 29 Cómo se organiza la información → 25 Normas de estilo y nombres.
• Mientras tanto: Documentación:Arquitectura de Documentación en Casiopea · Formulario:Nueva Documentación de Casiopea.
• Fuentes (Casiopea): la doctrina de documentación, la ficha v0.4, la brújula de Diátaxis (Inventario y propuesta de ficha §4) y la regla de <noinclude> de las plantillas.
• Documentación oficial: Page Forms · SMW Help:Properties and types · Extension:TemplateStyles · Help:Templates · diataxis.fr.

F5 · Documenta una obra

• Problema: las obras (por ejemplo, de Ciudad Abierta o de travesías) no tienen un recorrido propio; aparecen solo como campo dentro de otros objetos.
• Criterio de éxito: se crea una obra enlazada a su travesía o proyecto y a sus autores, y aparece en Mis Obras de cada Persona.
• Antes / Después: 2 → F2.
• Mientras tanto: Plantilla:Obra · Plantilla:Mis Obras.
• Fuentes (Casiopea): Plantilla:Obra, Categoría:Obra.
• Documentación oficial: Page Forms · SMW Help:Inline queries.

F6 · Publica una observación

• Problema: la observación es una práctica formativa de la Escuela y ya hay más de 300 en la wiki (Categoría:Observación Anotada), pero nada enseña a publicar una con su croquis, su texto y sus palabras clave.
• Criterio de éxito: un alumno publica una observación con imagen, nota y palabras clave, y la encuentra en Categoría:Observación Anotada y en la consulta de observaciones por autor.
• Antes / Después: 2 Crea tu página de Persona → 12 Insertar imágenes y galerías.
• Mientras tanto: Formulario:Nueva Observación · Categoría:Observación Anotada · La Observación de la Semana.
• Fuentes (Casiopea): Plantilla:Observación (imagen, posición, nota, fecha, autor, palabras clave, páginas y proyectos relacionados), Formulario:Nueva Observación.
• Documentación oficial: Page Forms · SMW Help:Inline queries.
• Por confirmar: cómo se elige La Observación de la Semana y si un alumno puede postular la suya.

F7 · Ajustar tu lectura (tema, ancho y tipografía)

• Problema: Stella Nova permite elegir tema claro u oscuro, cuatro anchos de lectura y la familia del texto (sans o serif), pero el usuario no sabe que existen esas opciones.
• Criterio de éxito: un usuario cambia el tema y el ancho, y la preferencia se mantiene en su próxima visita.
• Antes / Después: ninguno → F10.
• Mientras tanto: Especial:Preferencias · Stella Nova/Páginas del skin.
• Fuentes (Casiopea): docs/DISENO.md y docs/LAYOUTS.md §4 (panel de preferencias) de Stella Nova.
• Documentación oficial: Stella Nova docs/DISENO.md, docs/LAYOUTS.md §4 · MediaWiki Help:Preferences.

F8 · Explorar la Biblioteca Con§tel (pasó a la rama Con§tel)

• Qué cambió: la revisión del Manual de con§tel mostró que la Biblioteca Con§tel es un catálogo de textos para leer, no la herramienta. El problema real era aprender a anotar y a leer el mapa, así que F8 pasó a ser el tutorial C1, «Tu primera lectura en con§tel», dentro de una rama propia con página puerta (C0) y un tema por modo (C2 a C17).
• Criterio de éxito (C1): una persona activa con§tel, anota un pasaje de un texto de la Biblioteca y encuentra su concepto en el mapa.
• Documentación oficial: Manual de con§tel (resuelve D-10).

F9 · Escribir texto alternativo para tus imágenes

• Problema: Stella Nova apunta a WCAG 2.1 AA, pero el contenido que escriben los usuarios no lo cumple si las imágenes no tienen alt. Nadie lo enseña.
• Criterio de éxito: las imágenes de las páginas nuevas incluyen un alt descriptivo (se puede revisar en la auditoría mensual).
• Antes / Después: 12 → 25.
• Mientras tanto: 12 Insertar imágenes y galerías · 21 Sintaxis, sección Imágenes.
• Fuentes (Casiopea): |alt= en la sintaxis de imágenes, criterios de accesibilidad de la skin.
• Documentación oficial: W3C WAI Images Tutorial · MediaWiki Help:Images (parámetro alt).

F10 · Imprimir o guardar una página como PDF

• Problema: la skin tiene una vista previa de impresión con formatos A4, A3 y plóter, márgenes proporcionales y orientación (v0.8.4 a v0.9.0), pero no está documentada para el usuario, que la usa para entregas de taller.
• Criterio de éxito: un alumno exporta su página como PDF en A3 horizontal sin elementos de interfaz.
• Antes / Después: F7 → ninguno.
• Mientras tanto: la opción de impresión del menú de página.
• Fuentes (Casiopea): CHANGELOG de Stella Nova 0.8.4 a 0.9.0, resources/print-preview.js y print.css.
• Documentación oficial: Stella Nova CHANGELOG 0.8.4 a 0.9.0 · docs/LAYOUTS.md §6 (impresión).

F11 · Registrar una publicación o una tesis

• Problema: las publicaciones y tesis de magíster se consultan en la portada, pero no hay una guía para registrarlas.
• Criterio de éxito: una tesis registrada aparece en la consulta de la portada (Tipo de Publicación::Tesis de Magister).
• Antes / Después: 8 → 16.
• Mientras tanto: Plantilla:Publicación · Formulario:Nueva Publicación.
• Fuentes (Casiopea): Plantilla:Publicación, Plantilla:Revista Académica, portada Casiopea (sección Magíster).
• Documentación oficial: Page Forms · SMW Help:Inline queries · Extension:Cite.

F12 · Registrar un evento o una exposición

• Problema: existen las plantillas Evento y Exposición (Exposición tiene un bug estructural reportado en Pendientes), pero no hay guía.
• Criterio de éxito: un evento creado aparece enlazado a su curso o proyecto.
• Antes / Después: 8 → ninguno.
• Mientras tanto: Plantilla:Evento · Plantilla:Exposición.
• Fuentes (Casiopea): Formulario:Nuevo Evento. Primero hay que corregir el bug de Plantilla:Exposición.
• Documentación oficial: Page Forms · SMW Help:Properties and types (fechas).

F13 · Documentar investigación y vinculación con el medio

• Problema: hay formularios para Proyecto de Investigación, Proyecto de Vinculación con el Medio y Trabajo en MADLAB, sin ninguna ayuda que los distinga ni explique cuándo usar cada uno.
• Criterio de éxito: un profesor elige el formulario correcto para su proyecto, sin preguntar.
• Antes / Después: 8 → 29.
• Mientras tanto: Ontología de Casiopea · los formularios correspondientes.
• Fuentes (Casiopea): Ontología de Casiopea, Casiopea:Modelo semántico, menú "Vinculación con el Medio".
• Documentación oficial: Page Forms · SMW Help:Properties and types.

F14 · Registrar un objeto del Archivo Histórico

• Problema: el Archivo Histórico José Vial Armstrong usa Objeto de Archivo (que tiene un bug estructural reportado), y los criterios de catalogación no están escritos.
• Criterio de éxito: un objeto de archivo se registra con sus metadatos completos y aparece en el Archivo.
• Antes / Después: 32 Roles y permisos → 24 Propiedades semánticas.
• Mientras tanto: Archivo Histórico José Vial Armstrong · Plantilla:Objeto de Archivo.
• Fuentes (Casiopea): Plantilla:Objeto de Archivo. Hay que confirmar los criterios del archivo con el equipo del Archivo Histórico.
• Documentación oficial: Page Forms · SMW Help:Properties and types · Help:Images (archivos).

F21 · Cataloga las páginas de un cuaderno

• Problema: los cuadernos del Archivo Histórico José Vial Armstrong se catalogan página por página con Plantilla:Página de Cuaderno, una plantilla patrimonial con valores controlados (carilla, parte, lenguajes, estructuras, actividad, ejercicio), y esos criterios no están escritos. Varias páginas forman el cuaderno de un autor; no tienen relación con las observaciones.
• Criterio de éxito: una carilla escaneada queda catalogada con sus valores controlados, aparece en su cuaderno ordenada por número correlativo y llega a Cuadernograma.
• Antes / Después: F14 Registrar un objeto del Archivo Histórico → 24 Propiedades semánticas.
• Mientras tanto: Plantilla:Página de Cuaderno · Formulario:Nuevo Cuaderno.
• Fuentes (Casiopea): Plantilla:Página de Cuaderno, Categoría:Página de Cuaderno, Cuadernograma.
• Documentación oficial: Page Forms · SMW Help:Properties and types.
• Bloqueo: D-11, criterios de catalogación del Equipo del Archivo Histórico.

F15 · Seguir cambios y conversar sobre una página

• Problema: nadie sabe usar la lista de seguimiento ni las páginas de discusión, así que los avisos y la coordinación ocurren fuera de la wiki.
• Criterio de éxito: un profesor sigue las páginas de las tareas de su curso y recibe sus cambios.
• Antes / Después: 15 Saber quién editó una página → ninguno.
• Mientras tanto: Cambios recientes · Especial:Lista de seguimiento.
• Fuentes (Casiopea): Especial:Lista de seguimiento y las páginas de discusión de la wiki.
• Documentación oficial: MediaWiki Help:Watchlist · Help:Talk pages.

F16 · Cómo se cuida Casiopea

• Problema: los usuarios no entienden por qué se borra o se mueve contenido, quién revisa ni qué es una página protegida. Eso genera desconfianza ante las acciones de mantención (como los 1.946 borrados de mayo).
• Criterio de éxito: en el test, un usuario explica con sus palabras por qué se pudo haber movido una página suya.
• Antes / Después: 27 Qué es Casiopea → 32 Roles y permisos.
• Mientras tanto: Casiopea:Políticas · Casiopea:Administradores.
• Fuentes (Casiopea): Casiopea:Políticas, Casiopea:Administradores/Tareas, Casiopea:Plan de mitigación para bots.
• Documentación oficial: MediaWiki Help:Protected pages · Help:Deletion and undeletion · Help:Moving a page.

---

F17 · Ser administrador de Casiopea

• Problema: las páginas puerta (35) invitan a hacerse administrador, pero no existe un proceso escrito. Casiopea:Nuevos Administradores explica qué hace un administrador, pero no cómo se llega a serlo.
• Criterio de éxito: una persona interesada sabe qué requisitos se piden, a quién escribir y qué pasa después, y la solicitud llega a la administración.
• Antes / Después: 35 o 32 Roles y permisos → Casiopea:Solicitudes.
• Mientras tanto: Casiopea:Nuevos Administradores · Casiopea:Solicitudes.
• Fuentes (Casiopea): Casiopea:Nuevos Administradores, Casiopea:Administradores, Casiopea:Usuarios. ⚠ Falta definir los criterios y el canal: no se puede redactar sin esa decisión.
• Documentación oficial: MediaWiki Help:User rights and groups · Help:Sysops and permissions.

F18 · Incrustar mapas y ubicaciones

• Problema: la wiki tiene tres formas de mostrar un mapa (la extensión Maps y los widgets Google Maps y Google Street View), pero ninguna está documentada ni aparece en la Guía para incrustar objetos. Las guías 13 y 42 no las cubren.
• Criterio de éxito: una persona muestra en su página un mapa con uno o varios lugares (por ejemplo, el recorrido de una travesía) sin pedir ayuda.
• Qué cubre: {{#display_map:…}} de la extensión Maps (recomendado: no depende de una clave de Google) · Widget:Google Maps · Widget:Google Street View.
• Antes / Después: 9 Dar formato al texto → F2 Documenta una travesía.
• Mientras tanto: 23 Plantillas de interfaz (catálogo de lo que se puede incrustar) · 13 Incrustar video, audio, código y 3D.
• Fuentes (Casiopea): Especial:Versión (Maps 12.1.4) y las páginas Widget:Google Maps y Widget:Google Street View, que no tienen documentación.
• Documentación oficial: Maps, Displaying Leaflet maps (maps.extension.wiki).

F19 · Tu primer sketch en Casiopea

• Problema: las fichas de P5, P5m y P5js explican parámetros y limitaciones, pero nadie enseña a escribir un primer sketch que funcione en la wiki. Los avisos (un sketch por página en P5, prefijo p. en P5m, el operador ||) aparecen sueltos.
• Criterio de éxito: una persona sin experiencia publica en su página un sketch animado que funciona, y entiende cuándo usar P5, P5m o P5js.
• Antes / Después: 13 → Widget:P5m (referencia).
• Mientras tanto: 13 Incrustar video, audio, código y 3D.
• Fuentes (Casiopea): Widget:P5, Widget:P5m (ejemplos de círculos, estrellas, flores y partículas), Widget:P5js.
• Documentación oficial: p5js.org (referencia y tutoriales).

F20 · Arma una galería con tus fotos de Flickr

• Problema: Widget:FlickrSetShow está bien documentado como referencia, pero no hay un recorrido que lleve de un álbum de Flickr a una galería en la página.
• Criterio de éxito: una persona muestra un álbum propio como grilla y luego lo cambia a carrusel.
• Antes / Después: 12 → Widget:FlickrSetShow (referencia).
• Mientras tanto: 12 Insertar imágenes y galerías.
• Fuentes (Casiopea): Widget:FlickrSetShow (modos de visualización y ajustes de la grilla).
• Documentación oficial: Flickr (álbumes y privacidad).

4. Decisiones

Revisadas el 9 de octubre de 2026.