Toolbox — Sesión 06: Recursos oficiales vs no oficiales

Objetivo de la sesión

Al terminar esta sesión serás capaz de:

1. Encontrar la documentación oficial de cualquier herramienta IA o framework
2. Distinguir un tutorial fiable de uno desactualizado o incorrecto
3. Usar los SDKs oficiales correctamente (no wrappers innecesarios)
4. Navegar Changelogs y Migration Guides para mantenerte al día
5. Construir tu directorio personal de fuentes de confianza

Vídeo: Cuando la documentación oficial te salva (y cuando no)

1. Mapa de documentación oficial

IAs generativas

Frameworks y herramientas

Regla: siempre empieza por la doc oficial

    Problema → Doc oficial (5 min)
      ↓ No encuentro solucion
    GitHub Issues del repo (3 min)
      ↓ No hay respuesta
    Stack Overflow / Reddit (5 min)
      ↓ No funciona
    Blog post / tutorial (verificar fecha primero)
      ↓ Ultima opcion
    Preguntar a una IA (verificar respuesta con doc oficial)
    

2. SDKs oficiales vs wrappers

Que es un SDK oficial

El SDK oficial es la librería creada y mantenida por el proveedor de la herramienta. Es la forma "bendecida" de usar su API.

Por que usar siempre el oficial

Cuando es aceptable un wrapper

Como verificar un SDK

    1. Ir al README de la herramienta (ej: anthropic.com)
    2. Buscar seccion "Getting Started" o "SDKs"
    3. Instalar el que ellos recomiendan
    4. Si usas algo diferente: preguntarte POR QUE
    

3. Tutoriales: como filtrar la basura

Los 5 filtros de calidad

Antes de seguir cualquier tutorial de blog, YouTube o Medium:

Red flags en tutoriales

• "Crea tu propio ChatGPT en 5 minutos" → Clickbait, el resultado no será usable
• Usa pip install openai==0.28 → Versión obsoleta (actual es 1.x)
• No menciona costes ni límites → Te llevaras sorpresas
• Mezcla código de diferentes versiones → No compila
• "Funciona perfectamente" sin testing → No lo ha probado en producción

Fuentes de tutoriales fiables

4. Changelogs y Migration Guides

Por que importan

Las APIs de IA cambian cada 2-4 semanas. Un código que funciona hoy puede romperse el mes que viene. Los changelogs te avisan de cambios. Las migration guides te dicen como adaptarte.

Donde encontrarlos

Como mantenerte al día sin perder 2 horas diarias

1. Suscribete a 3-5 newsletters (TLDR, The Batch, changelog de tu stack principal)
2. Watch en GitHub solo los repos que usas directamente (Releases only, no todos los commits)
3. Revisa changelogs 1 vez por semana (15 minutos, viernes)
4. Cuando actualices una dependencia: lee el changelog de TODAS las versiones entre tu actual y la nueva

5. Preguntar a la IA sobre documentación: precauciones

Cuando funciona

• Preguntar conceptos generales: "que es Server Components en Next.js?"
• Pedir ejemplos de uso: "ejemplo básico de Supabase auth con Next.js"
• Aclarar errores: "que significa este error: [pegar error]"

Cuando falla

• Sintaxis específica de versiones recientes: la IA puede mezclar versiones
• Parámetros de API que cambiaron: la IA puede dar parámetros obsoletos
• Comportamiento edge-case: la IA generaliza, los edge cases están en la doc

Workflow seguro

    1. Pregunta a la IA para orientarte
    2. Verifica en la doc oficial que la sintaxis es correcta
    3. Si la IA dice "usa function X", busca X en la doc oficial
    4. Si no existe en la doc oficial, la IA probablemente la invento
    

6. Context7: documentación actualizada para IAs

Que es

Context7 es un servicio MCP que proporciona documentación actualizada de frameworks y librerías directamente a las IAs. En lugar de que la IA responda con su conocimiento (potencialmente obsoleto), consulta la documentación actual.

Como usarlo

Si tienes Context7 configurado como MCP:

    "Usando context7, muestrame como crear un endpoint autenticado en FastAPI 0.115"
    

La IA consultara la documentación real de FastAPI 0.115 en lugar de responder de memoria.

Cuando usarlo

• Siempre que trabajes con una versión específica de un framework
• Cuando necesites sintaxis exacta (no aproximada)
• Cuando sospeches que la IA esta dando información obsoleta

7. Lab práctico: Crea tu directorio de fuentes

Instrucciones

Construye tu directorio personal de fuentes fiables para tu stack. 20 minutos.

Tu stack

    Frontend: _________________________________
    Backend: _________________________________
    Base de datos: _________________________________
    IA/LLM: _________________________________
    Deploy: _________________________________
    Otros: _________________________________
    

Directorio de fuentes

Para cada herramienta de tu stack, documenta:

Entregable de la sesión

Tu directorio de fuentes de confianza con al menos 5 herramientas documentadas.

    MI DIRECTORIO DE FUENTES
    =========================
    
    Stack: _________________________________
    Fecha: ____/____/2026
    
    REGLA: Doc oficial primero. Tutorial solo si < 6 meses y con codigo funcional.
    
    Newsletters suscritas:
    1. _________________________________
    2. _________________________________
    3. _________________________________
    
    Repos en Watch (GitHub):
    1. _________________________________
    2. _________________________________
    
    Dia de revision changelogs: _____________ (15 min/semana)
    

Recursos descargables

1. Mapa de documentación oficial (Notion) — URLs de docs, SDKs y changelogs de 30+ herramientas
2. Checklist verificación de fuentes (PDF) — Los 5 filtros de calidad en formato imprimible
3. Template directorio personal (Notion) — Base de datos para tu directorio de fuentes

Siguientes pasos

En la siguiente sesión (AB-07: GitHub como herramienta) vas a aprender a usar GitHub no solo como repositorio, sino como herramienta de descubrimiento, colaboración y gestión de licencias.

Antes de pasar a AB-07:

• Has creado tu directorio con al menos 5 herramientas
• Has verificado que usas SDKs oficiales en tus proyectos
• Has configurado al menos 1 newsletter técnica

Toolbox — Sesión 06 de 09

IAcademy — iacedemy.com