Por qué los tutoriales te están frenando (y qué hacer en su lugar)
Terminas el tutorial, todo funciona… y al abrir un proyecto vacío no sabes por dónde empezar. Te pasa porque el tutorial pensó por ti: eligió el orden, los nombres y los problemas. En un proyecto real nadie te los da.
La solución no es ver más contenido. Es tener un método para enfrentarte a una librería que no conoces.
1. Lee la documentación con un objetivo
No la leas de principio a fin. Busca, en este orden:
- Qué problema resuelve y qué no (suele estar en la introducción).
- El ejemplo mínimo de getting started: el código más pequeño que funciona.
- La referencia de las dos o tres funciones que vas a usar de verdad.
Si no puedes explicar en una frase para qué sirve la librería, todavía no has leído lo suficiente.
2. Escribe tests de aprendizaje
Un test de aprendizaje es un test sobre la librería, no sobre tu código. Escribes lo que crees que hace y dejas que te corrija:
import { test, expect } from 'vitest';
import { format } from 'date-fns';
test('format pads the month with zero', () => {
expect(format(new Date(2026, 0, 5), 'dd/MM/yyyy')).toBe('05/01/2026');
});
Si falla, has aprendido algo concreto. Y quedan como documentación viva: el día que actualices la librería, te avisan si algo cambió.
3. Aplícalo en un caso real
Añade una funcionalidad pequeña a tu proyecto con lo aprendido. Pequeña de verdad: un endpoint, un componente, un script. Es aquí donde aparecen las preguntas que la documentación no responde.
4. Lee el código fuente cuando la documentación no basta
Cuando algo no se comporta como dice la documentación, ve al código:
- Usa «Ir a la definición» en tu editor y entra en
node_modules. - En el repositorio, busca el nombre de la función y lee sus tests: suelen ser los mejores ejemplos de uso.
- Revisa los issues: probablemente alguien tuvo el mismo problema.
Al principio cuesta, pero leer código ajeno es lo que harás la mayor parte de tu carrera.
Los tutoriales no son el enemigo
Sirven para hacerte una idea general de una herramienta en una tarde. El problema es encadenarlos sin construir nada propio. Usa uno para orientarte y después sigue estos cuatro pasos.