Vídeo o documentación escrita: cuándo grabar y cuándo escribir

Todos los equipos acaban teniendo la misma discusión. Alguien dice «graba un vídeo rápido», otra persona responde «esto debería ser un documento», y la tarea se queda parada una semana mientras ambas partes esperan un veredicto.

La respuesta no es que un formato sea mejor. Es que el vídeo y el texto fallan en sitios distintos. El vídeo es insuperable para mostrar movimiento, secuencia y criterio. El texto es insuperable para hojear, buscar y corregir. Si eliges mal, o entierras una respuesta de dos líneas dentro de una grabación de ocho minutos, o pasas una tarde describiendo con palabras un gesto de arrastrar y soltar.

Esta guía te da una forma repetible de decidir en unos treinta segundos, antes de empezar.

La prueba de los treinta segundos

Hazte tres preguntas sobre aquello que quieres documentar.

1. ¿Se mueve? Si entenderlo exige ver algo suceder —el recorrido del cursor, un cambio de estado, una animación, una herramienta respondiendo en tiempo real—, grábalo.
2. ¿Alguien necesitará después una parte concreta? Si la gente volverá a consultar un valor, una opción o un paso específico, escríbelo. Nadie recorre una línea de tiempo para encontrar un número de puerto.
3. ¿Con qué frecuencia cambia? Si la pantalla cambia cada mes, el texto es más barato de mantener. Si es estable durante un año, el vídeo se amortiza.

Dos respuestas «vídeo» significan grabar. Dos «texto» significan escribir. Un empate suele significar que necesitas ambos, algo más fácil de lo que parece.

Cuándo gana el vídeo

Mostrar un flujo de trabajo entre varias herramientas. Lo difícil de la mayoría de los procesos no es ningún clic concreto, sino lo que ocurre entre aplicaciones. Una grabación captura todo el recorrido sin que tengas que describir seis cambios de contexto.

Todo lo que implique criterio visual. «Haz que el espaciado se sienta más equilibrado», «esta animación va muy rápida», «el gráfico necesita respirar más». Imposible de especificar por escrito y evidente en diez segundos de vídeo.

Informes de errores y reproducciones. Una grabación muestra la secuencia exacta, el momento exacto y el estado exacto. Elimina por completo el clásico «a mí no me pasa».

Onboarding y primeras impresiones. Quien acaba de llegar necesita ver qué aspecto tiene la soltura: cuánto debería durar una tarea, dónde duda alguien con experiencia, qué ignora. Los pasos escritos aplanan todo eso.

Cualquier cosa que si no explicarías tres veces en directo. Si has dicho lo mismo en tres reuniones, lo que hace falta es una grabación, no una cuarta reunión.

Transmitir el tono. Las devoluciones, las decisiones con matices y todo lo que pueda leerse como brusco funcionan mucho mejor con voz y cara.

Cuándo gana lo escrito

Material de referencia. Valores de configuración, parámetros de API, atajos de teclado, códigos de error. Todo lo que se consulta en lugar de aprenderse.

Todo lo que debe ser localizable. El texto lo indexan tu wiki, tu centro de ayuda y los buscadores. Un vídeo es una caja negra mientras no tenga transcripción.

Pasos que cambian a menudo. Editar una línea de un documento lleva segundos. Volver a grabar un fragmento, cuadrar el audio y reexportar lleva una hora, y cada fotograma desactualizado daña la confianza en toda la biblioteca.

Contenido que se necesita mientras se hace la tarea. Nadie quiere pausar, rebobinar y reanudar un vídeo con una mano mientras ejecuta una migración con la otra. Las listas de comprobación son para leerse.

Legal, cumplimiento y todo lo que exija una redacción exacta. Si la precisión importa más que la claridad, escríbelo, revísalo y versiónalo.

Contenido con mucha traducción. El texto se traduce barato a catorce idiomas. Volver a grabar la narración, no.

El formato que la mayoría de equipos necesita de verdad

La mejor documentación rara vez es una cosa u otra. Es una grabación corta con una columna vertebral escrita.

Un patrón fiable:

• Una página escrita como fuente de verdad. Título, propósito, requisitos previos, pasos numerados y los valores exactos en texto copiable.
• Una grabación de dos a cuatro minutos incrustada arriba. Muestra la forma de la tarea para que quien lee sepa a qué se enfrenta.
• Marcadores de capítulo y marcas de tiempo, para que el vídeo sea navegable en vez de lineal.
• Transcripción o subtítulos, para que el contenido sea buscable y accesible.

Quien necesita la idea general mira. Quien necesita un dato hojea. Ningún grupo sale perdiendo.

Mantén las grabaciones cortas para que sigan siendo válidas

El principal motivo por el que la documentación en vídeo se pudre es la duración. Una grabación de veinte minutos con ocho temas hay que rehacerla entera cuando cambia uno solo. Ocho grabaciones de tres minutos se reemplazan de una en una.

Reglas prácticas para mantener una videoteca sostenible:

• Un vídeo, un resultado. Si el título necesita una «y», divídelo.
• Apunta a menos de cinco minutos. La mayoría de las explicaciones de un proceso caben en tres.
• No grabes lo que cambia más rápido. Precios, fechas, nombres de equipos y textos de interfaz van en el texto junto al vídeo.
• Di la versión en voz alta o ponla en pantalla. «Grabado en la versión 4.2» convierte un vídeo obsoleto en un vídeo fechado, que es mucho menos dañino.
• Graba limpio. Modo No molestar activado, datos de demostración en lugar de registros reales de clientes, un tema visual coherente. Un clip reutilizable en tres sitios vale más que tres clips que no lo son.

Reduce el coste de grabar

La mayoría de las decisiones de «mejor lo escribimos» significan en realidad «grabar parece una producción». Bajar ese coste cambia el cálculo para todo el equipo.

• Sáltate la introducción. Empieza en la pantalla que importa. La documentación interna no necesita quince segundos de preámbulo.
• No escribas un guion palabra por palabra. Anota cinco puntos y habla sobre ellos. Los guiones hacen que suene a lectura y triplican la preparación.
• Arregla cortando, no volviendo a grabar. Recorta los silencios, la frase trabada y la carga larga. Casi cualquier toma se salva.
• Usa el zoom en lugar de narrar. Un zoom sobre el botón que has pulsado sustituye a la frase que explicaba dónde estaba.
• Con una buena toma basta. La documentación interna no necesita un cuarto intento. Publícala.

Una política de equipo sencilla

Si quieres cerrar este debate, escribe cuatro líneas:

1. Referencia y configuración → texto. Siempre.
2. Flujos de trabajo, demos y comentarios → vídeo. Menos de cinco minutos.
3. Todo lo que se usa durante una tarea → lista escrita, con un vídeo general opcional.
4. Todo lo que cambia más de una vez por trimestre → texto, salvo que lo visual sea el objetivo.

Y añade una regla que importa más que las otras cuatro: cada vídeo lleva un título escrito, un resumen de una frase y un enlace desde el documento correspondiente. Una grabación que nadie encuentra es una grabación que no existió.

Reflexión final

Elegir formato no es una preferencia de estilo: es una decisión de mantenimiento que tomas en nombre de todas las personas que leerán tu trabajo dentro de seis meses. El vídeo compra comprensión. El texto compra durabilidad. Los equipos con mejor documentación no son los que eligieron un bando, sino los que dejaron de discutir, grabaron lo que merecía verse, escribieron lo que merecía consultarse y enlazaron ambas cosas.