Diferencias entre versiones

Qué cambió entre dos modelos.

Definición

Las diferencias entre versiones listan los cambios entre la versión N y la N+1 de un modelo en cuatro clases: añadido, retirado, renombrado y resignificado. El resignificado —mismo nombre, otro significado— va el último, en el único marco grueso y con un signo igual en lugar de una flecha. Sirve para notas de cambio de un modelo de datos, un glosario o una taxonomía.

Editar con tus datos SVG Spec JSON

Tres cambios se ven venir; el cuarto no rompe nada y cambia las cifras

Datos: clase · pieza · antes · despues · nota · rol
Buena para: Ver qué cambió entre dos versiones y, sobre todo, qué cambió sin que el nombre lo delate.
Evítala cuando: Cuando los dos vocabularios pertenecen a sistemas distintos y no son versiones del mismo.
Se lee bien: Entre 2 y 16 elementos; dibuja hasta 20
Datos que faltan: Se niega a dibujar y dice qué valor falta.
Accesibilidad: Lector de pantalla: tabla de datos · respeta «reducir movimiento»

Forma de los datos

Qué columnas pide

Columna	Tipo	Para qué
`clase`	string	Cuál de las cuatro clases de cambio es: anadido · retirado · renombrado · resignificado. Cerrada: cualquier otra cosa hace FALLAR con las cuatro escritas.
`pieza`	string	De qué pieza del modelo habla la entrada. Obligatoria: sin ella la fila no dice de qué habla.
`antes`	string	Cómo se llamaba en N. Obligatoria en «retirado» y en «renombrado».
`despues`	string	Cómo se llama en N+1. Obligatoria en «anadido» y en «renombrado».
`nota`	string	El motivo del cambio. Obligatoria en «resignificado»: es la única clase en la que el nombre no dice nada, así que sin la nota la entrada no informa y la pieza se niega.
`rol` · opcional	string	neutro · foco · alerta · ausente · favorable.

Tamaños

Ancha por necesidad

Esta pieza necesita anchura para que cada rótulo quepa entero. El motor prefiere decirlo a apretarla.

A menos de 480 px sus rótulos no caben sin pisarse o recortarse, y el motor no la publica así. En el móvil se ve la versión ancha, a tamaño legible y sin recortar, dentro de un marco que se desliza.

Cuándo usarla

Tres preguntas antes de elegirla

¿Comparas dos versiones del mismo modelo?

Si son dos vocabularios distintos que hay que emparejar, usa la tabla de correspondencias.

Sí: quédate con diferencias entre versiones

No: usa Tabla de correspondencias

¿Hace falta listar los cambios uno a uno?

Si basta con contrastar el modelo de antes y el de después en bloque, las columnas enfrentadas los ponen lado a lado.

Sí: quédate con diferencias entre versiones

No: usa Columnas enfrentadas

¿Bastan los cambios, sin dibujar el modelo entero?

Si hay que ver las entidades y sus relaciones, el diagrama entidad-relación lo dibuja completo.

Sí: quédate con diferencias entre versiones

No: usa Diagrama entidad-relación

Código

La misma pieza, con tus datos

import { getPreset, renderComposition } from 'visx-render/node';

const spec = await getPreset('concept-diff');
spec.data.rows = misFilas; // clase, pieza, antes, despues, nota
const { svg, warnings } = await renderComposition(spec);

También en React con Chart y prepareComposition. Guía para desarrolladores →

Dudas

¿Qué clases de cambio admite?

Cuatro: añadido, retirado, renombrado y resignificado. Cualquier otra hace fallar la pieza con las cuatro escritas.

¿Por qué la nota es obligatoria en un resignificado?

Porque es la única clase en la que el nombre no cambia: sin el motivo escrito, la entrada no informa de nada.

¿Qué hace si faltan datos?

Se niega a dibujar y dice qué valor falta.

¿Cómo se ve en el móvil?

A menos de 480 px el motor no la compone sin pisar o cortar rótulos, y lo dice. En el móvil se ve la versión ancha, a tamaño legible, dentro de un marco que se desliza.

Relacionadas

Otras formas de responder «cómo cambia en el tiempo»

Guía para elegir: cómo cambia en el tiempo →