# Instrucciones para evaluar un recurso educativo abierto (evaluación VCER)

Estas instrucciones proceden de la guía «Vibe coding responsable», para
publicar materiales educativos creados con vibe coding
(https://vibe-coding-educativo.github.io/vibe-responsable/).
Sirven para evaluar un recurso ya hecho, propio o de otra persona, se haya
creado o no siguiendo la guía.

## Cómo evaluar

- Trabaja sobre el código del recurso que te doy. Si no lo tienes, pídemelo
  antes de empezar.
- No lo corrijas: solo evalúalo.
- Puntúa cada uno de los diez puntos con 2, 1 o 0 según la rúbrica VCER
  (vibe coding educativo responsable), y justifica cada puntuación con una
  frase sobre lo que has visto en el recurso.
- Si un punto no puede comprobarse con lo que te he dado, déjalo sin puntuar y
  di qué haría falta para comprobarlo.
- Antes de puntuar, haz inventario completo, no una muestra: cada función que
  pide o guarda datos de personas y cómo se exportan o copian; cada imagen,
  sonido, vídeo, icono y tipografía del proyecto, y de dónde sale (mira las
  imágenes: un logotipo redibujado sigue siendo ajeno); y todo lo que se carga
  de fuera, y cuándo (al abrir, al pulsar algo o en una ventana nueva).
- Si el recurso está publicado, evalúa esa versión o comprueba que coincide
  con el código que te han dado. Anota qué versión has evaluado: la etiqueta
  de versión y el commit si está en un repositorio, o la dirección y la fecha
  de la evaluación si no lo está.
- Para el punto 5, si puedes ejecutar código, abre el recurso en un navegador
  y pásale una herramienta automática de accesibilidad, como axe-core, también
  con contenido cargado y no solo en la pantalla inicial. No cuentes lo que se
  incrusta de otros sitios. La herramienta no comprueba el manejo con el
  teclado: recórrelo con el tabulador. En la justificación del punto, di qué
  has probado y cómo; si solo has podido leer el código, indícalo.

## Rúbrica VCER

1. CONTENIDO (eliminatorio)
   2: No se detectan errores en lo que enseña: los datos, las definiciones
      y las respuestas que se dan por correctas.
   1: Hay alguna imprecisión menor en lo que enseña.
   0: Hay errores evidentes en conceptos, datos o respuestas.
   Esta puntuación solo refleja los errores que has detectado: enumera cada
   uno y señala lo que conviene que compruebe una persona. Las erratas y los
   fallos de formato de las referencias no restan aquí: señálalos aparte.

2. DATOS PERSONALES (eliminatorio)
   2: No pide datos que identifiquen a nadie, o los guarda solo en el
      dispositivo y permite exportar sin nombres; o los envía únicamente a
      un servicio del centro, sin claves visibles en el código y de forma
      que solo el docente o el centro puedan leerlos. No lleva analítica.
   1: No envía datos del alumnado a servicios ajenos, pero guarda nombres
      sin opción de exportar sin ellos, o el envío al servicio del centro no
      está bien protegido (claves en el código, una dirección que permite
      leer lo recogido).
   0: Envía datos del alumnado a un servidor ajeno al centro, o lleva
      analítica o seguimiento.
   Si el recurso maneja datos reales del alumnado, indica que conviene la
   revisión de una persona con conocimientos técnicos antes de usarlo.
   Lo que se carga o se incrusta de otros servidores (vídeos, audios,
   tipografías, bibliotecas) se valora en el punto 4, no aquí.

3. ENTENDER QUÉ HACE
   2: Puede describirse brevemente qué hace, qué guarda y con qué se
      comunica, y lo que declara el material coincide con el código.
   1: Se entiende su funcionamiento, pero hay partes de propósito poco claro
      o no explica qué guarda.
   0: Hay funciones o comunicaciones cuyo propósito no puede explicarse, o lo
      que declara no coincide con el código.

4. DEPENDENCIAS
   2: Lo que carga o incrusta de fuera procede de servicios conocidos y está
      anotado, y los textos, imágenes y datos propios están dentro del
      material.
   1: Carga o incrusta recursos externos sin anotarlos, o parte del
      contenido propio (un vídeo, un audio, un mapa) solo está en otra
      plataforma.
   0: El contenido principal depende de un servicio externo, o carga código
      de direcciones desconocidas.

5. ACCESIBILIDAD
   2: Se maneja entero con el teclado, los controles tienen etiqueta, las
      imágenes texto alternativo, el contraste es suficiente, no depende del
      color y se adapta a una pantalla estrecha.
   1: Falla en uno o dos de esos aspectos, sin impedir su uso.
   0: Falla en tres o más, o no puede usarse con el teclado.

6. MATERIAL AJENO
   2: Cada elemento ajeno indica autoría, procedencia y licencia, y la
      licencia permite reutilizarlo; o no hay material ajeno.
   1: Hay material ajeno con licencia válida, pero sin acreditar del todo.
   0: Hay material ajeno sin licencia que permita reutilizarlo o sin ninguna
      atribución.

7. RASTRO
   2: Hay un registro o una nota con las decisiones importantes y su motivo.
   1: Hay documentación que explica cómo está hecho, pero no por qué.
   0: No hay nada.

8. USO DE IA
   2: Indica que se ha hecho con IA y qué ha comprobado la persona.
   1: Indica que se ha hecho con IA, sin decir qué se ha comprobado.
   0: No lo indica. Si consta que no se usó IA, no se puntúa.

9. LICENCIA
   2: Autoría y licencia libre visibles en el material, con enlace. Si es un
      proyecto de varios archivos, incluye el archivo de licencia.
   1: Falta la autoría o la licencia, la licencia no es libre (NC o ND) o no
      enlaza a su texto.
   0: No indica ni autoría ni licencia.

10. REUTILIZACIÓN
   2: El código puede obtenerse completo, se entiende al leerlo, con
      comentarios donde hacen falta, y hay indicaciones para modificarlo.
   1: Puede obtenerse, pero es difícil de entender sin comentarios, está en
      parte comprimido o no tiene indicaciones.
   0: No puede obtenerse, o está ofuscado o comprimido.

## Resultado

- Calcula el porcentaje: la suma de las puntuaciones dividida entre el máximo
  posible de los puntos puntuados.
- Da un resultado: «No recomendable» si el punto 1 o el 2 tienen 0, sea cual
  sea el porcentaje; «Mejorable» por debajo del 70 %; «Recomendable» a partir
  del 70 %, siempre que los puntos 1 y 2 se hayan podido puntuar y el punto 5
  no tenga 0. Si alguno de los puntos 1 y 2 ha quedado sin puntuar, el
  resultado es «Mejorable» e indica qué falta por comprobar; si el punto 5
  tiene 0, también es «Mejorable» e indica qué impide usarlo.
- Empieza el informe con una línea como «Rúbrica VCER: Recomendable
  (85 %)», seguida de otra con la versión evaluada, y añade debajo una frase
  con lo que significa ese resultado:
  - Recomendable: cumple lo esencial de la guía y puede utilizarse o
    publicarse; las mejoras propuestas lo completan.
  - Mejorable: tiene fallos que conviene corregir antes de publicarlo o
    recomendarlo, aunque ninguno lo descarta.
  - No recomendable: tiene errores evidentes en lo que enseña o envía datos
    del alumnado a servicios ajenos al centro; no conviene utilizarlo ni
    publicarlo hasta corregirlo.
- En la justificación del punto 3, incluye esa breve descripción. En la
  del 4, enumera las direcciones externas del código y para qué sirve cada
  una, y di con palabras sencillas qué dejaría de funcionar al abrirlo
  descargado en un ordenador sin internet. En la del 6, enumera el material
  ajeno.
- Termina con las tres mejoras que más subirían la puntuación.

## Si el recurso es mío

- Haz esto solo si el recurso es mío y puedes modificar sus archivos. Si no
  sabes si es mío, pregúntamelo al terminar el informe. Si es de otra persona
  o no puedes modificar sus archivos, no lo menciones.
- Ofréceme estas dos cosas y haz solo las que apruebe:
  - Si el proyecto tiene una carpeta propia, como un repositorio, guardar el
    informe completo en un archivo llamado evaluacion-vcer.md, que sustituye
    al de una evaluación anterior.
  - Añadir al pie del material, en su idioma, una mención con el resultado,
    como «Evaluación VCER de la versión 1.2: Recomendable (85 %), octubre de
    2026», enlazada a una dirección como esta:
    https://vibe-coding-educativo.github.io/vibe-responsable/vcer/?r=recomendable&p=85&f=2026-10&v=1.2&t=Fracciones%20equivalentes&u=https%3A%2F%2Fejemplo.github.io%2Ffracciones%2F
- En el enlace, r es el resultado (recomendable, mejorable o
  no-recomendable); p, el porcentaje; f, el año y el mes de la evaluación;
  v, la versión evaluada; t, el título del recurso, el mismo que figura en
  su pie, y u, su dirección. Codifica t y u como se hace en una dirección
  web.
- Si el recurso no tiene número de versión, quita «de la versión 1.2» de la
  mención y v del enlace. Si no está publicado en la web, quita u del
  enlace.
- El porcentaje es opcional: ofréceme la mención con él y sin él. Sin
  porcentaje, quita «(85 %)» de la mención y p del enlace.
- Si ya hay una mención, actualízala con el resultado nuevo.

## Si después te pido corregirlo

- Antes de cambiar nada, dime qué cambiarías y espera a que lo apruebe. No
  cambies el contenido ni el funcionamiento, salvo que te lo pida.
- Si no hay nota de decisiones, escribe una que describa cómo funciona el
  recurso ahora, e indica que se ha redactado después.
- Si falta la licencia o la indicación de uso de IA, prepárame el texto para
  añadirlo.