fix(ruta-aprendizaje): resolve broken links in learning path modules

TellMeAlex · TellMeAlex · commit 6fe5884204c8 · 2026-01-07T18:44:35.000+01:00
- Add explicit slug frontmatter to all 6 learning modules to prevent Docusaurus URL stripping
- Remove .md file extensions from internal links in intro.mdx (Docusaurus resolves extension-less links)
- Create _category_.json for ruta-aprendizaje-ia-agents directory to enable proper autogenerated sidebar

Issues fixed:
- Docusaurus was stripping numeric prefixes (01-, 02-, etc.) from filenames in URL resolution
- Links with explicit .md extensions were not being resolved correctly
- Missing _category_.json prevented proper document registration

Build now passes successfully with no broken links.
diff --git a/.worktrees/001-acabo-de-revisa-que-en-el-proyecto-del-portafolio- b/.worktrees/001-acabo-de-revisa-que-en-el-proyecto-del-portafolio-
@@ -0,0 +1 @@
+Subproject commit a79cfcd7256b0c11de5a795e79242b4d38f404fb
diff --git a/.worktrees/002-technical-debt-cleanup b/.worktrees/002-technical-debt-cleanup
@@ -0,0 +1 @@
+Subproject commit 7b2885c63fc2a93ffc9b214584c43ba2e82b7ef2
diff --git a/.worktrees/003-ai-agent-development-learning-path b/.worktrees/003-ai-agent-development-learning-path
@@ -0,0 +1 @@
+Subproject commit 903e44d74d131964cd53ceb8999bb007bd0d21a3
diff --git a/.worktrees/005-complete-incomplete-documentation-sections b/.worktrees/005-complete-incomplete-documentation-sections
@@ -0,0 +1 @@
+Subproject commit 4cd731df7daa869d6cbd81ecf34908e7db7d4e79
diff --git a/docs/ruta-aprendizaje-ia-agents/01-fundamentos.mdx b/docs/ruta-aprendizaje-ia-agents/01-fundamentos.mdx
@@ -1,5 +1,6 @@
 ---
 sidebar_position: 2
+slug: 01-fundamentos
 ---
 
 import ModuleCompleteButton from '@site/src/components/ModuleCompleteButton';
diff --git a/docs/ruta-aprendizaje-ia-agents/02-typescript.mdx b/docs/ruta-aprendizaje-ia-agents/02-typescript.mdx
@@ -1,5 +1,6 @@
 ---
 sidebar_position: 3
+slug: 02-typescript
 ---
 
 import ModuleCompleteButton from '@site/src/components/ModuleCompleteButton';
diff --git a/docs/ruta-aprendizaje-ia-agents/03-conceptos.mdx b/docs/ruta-aprendizaje-ia-agents/03-conceptos.mdx
@@ -1,5 +1,6 @@
 ---
 sidebar_position: 4
+slug: 03-conceptos
 ---
 
 import ModuleCompleteButton from '@site/src/components/ModuleCompleteButton';
diff --git a/docs/ruta-aprendizaje-ia-agents/04-agentes-avanzados.mdx b/docs/ruta-aprendizaje-ia-agents/04-agentes-avanzados.mdx
@@ -1,5 +1,6 @@
 ---
 sidebar_position: 5
+slug: 04-agentes-avanzados
 ---
 
 import ModuleCompleteButton from '@site/src/components/ModuleCompleteButton';
diff --git a/docs/ruta-aprendizaje-ia-agents/05-mcp-servers.mdx b/docs/ruta-aprendizaje-ia-agents/05-mcp-servers.mdx
@@ -1,5 +1,6 @@
 ---
 sidebar_position: 6
+slug: 05-mcp-servers
 ---
 
 import ModuleCompleteButton from '@site/src/components/ModuleCompleteButton';
diff --git a/docs/ruta-aprendizaje-ia-agents/06-produccion.mdx b/docs/ruta-aprendizaje-ia-agents/06-produccion.mdx
@@ -1,5 +1,6 @@
 ---
 sidebar_position: 7
+slug: 06-produccion
 ---
 
 import ModuleCompleteButton from '@site/src/components/ModuleCompleteButton';
diff --git a/docs/ruta-aprendizaje-ia-agents/_category_.json b/docs/ruta-aprendizaje-ia-agents/_category_.json
@@ -0,0 +1,6 @@
+{
+  "label": "Ruta de Aprendizaje: IA Agents",
+  "position": 1,
+  "collapsible": true,
+  "collapsed": false
+}
diff --git a/docs/ruta-aprendizaje-ia-agents/intro.mdx b/docs/ruta-aprendizaje-ia-agents/intro.mdx
@@ -59,11 +59,11 @@ Los agentes de IA no son "scripts de juguete". Manejan:
 
 | Si ya sabes... | Empieza en... |
 |----------------|---------------|
-| Nada de IA, pero sé JavaScript | [Módulo 1: Fundamentos](./01-fundamentos.md) |
-| Conceptos de IA, pero no TypeScript | [Módulo 2: TypeScript Esencial](./02-typescript.md) |
-| TypeScript + conceptos de IA básicos | [Módulo 3: Conceptos de Agentes](./03-conceptos.md) |
-| Ya construí agentes simples | [Módulo 4: Agentes Avanzados](./04-agentes-avanzados.md) |
-| Quiero crear herramientas para Claude | [Módulo 5: MCP Servers](./05-mcp-servers.md) |
+| Nada de IA, pero sé JavaScript | [Módulo 1: Fundamentos](./01-fundamentos) |
+| Conceptos de IA, pero no TypeScript | [Módulo 2: TypeScript Esencial](./02-typescript) |
+| TypeScript + conceptos de IA básicos | [Módulo 3: Conceptos de Agentes](./03-conceptos) |
+| Ya construí agentes simples | [Módulo 4: Agentes Avanzados](./04-agentes-avanzados) |
+| Quiero crear herramientas para Claude | [Módulo 5: MCP Servers](./05-mcp-servers) |
 
 ## 📖 Rutas de Aprendizaje
 
@@ -136,12 +136,12 @@ flowchart LR
 
 | Módulo | Duración | Requisitos | Aprenderás |
 |--------|----------|-----------|-----------|
-| **[1. Fundamentos](./01-fundamentos.md)** | 1.5 horas | JavaScript básico | Qué es un agente de IA, LLMs, APIs, prompting básico |
-| **[2. TypeScript Esencial](./02-typescript.md)** | 2 horas | Módulo 1, ES6+ | Tipos para APIs, zod validation, error handling |
-| **[3. Conceptos de Agentes](./03-conceptos.md)** | 2.5 horas | Módulo 2 | Tool calling, ReAct pattern, state management |
-| **[4. Agentes Avanzados](./04-agentes-avanzados.md)** | 3 horas | Módulo 3 | Prompt engineering, context windows, streaming |
-| **[5. MCP Servers](./05-mcp-servers.md)** | 2.5 horas | Módulo 4 | Protocolo MCP, FastMCP, tool schemas |
-| **[6. Producción](./06-produccion.md)** | 3 horas | Módulo 5 | Testing, security, deployment, monitoring |
+| **[1. Fundamentos](./01-fundamentos)** | 1.5 horas | JavaScript básico | Qué es un agente de IA, LLMs, APIs, prompting básico |
+| **[2. TypeScript Esencial](./02-typescript)** | 2 horas | Módulo 1, ES6+ | Tipos para APIs, zod validation, error handling |
+| **[3. Conceptos de Agentes](./03-conceptos)** | 2.5 horas | Módulo 2 | Tool calling, ReAct pattern, state management |
+| **[4. Agentes Avanzados](./04-agentes-avanzados)** | 3 horas | Módulo 3 | Prompt engineering, context windows, streaming |
+| **[5. MCP Servers](./05-mcp-servers)** | 2.5 horas | Módulo 4 | Protocolo MCP, FastMCP, tool schemas |
+| **[6. Producción](./06-produccion)** | 3 horas | Módulo 5 | Testing, security, deployment, monitoring |
 
 ## 🛠️ Proyectos por Módulo
 
@@ -183,4 +183,4 @@ Si llegas a un módulo y no entiendes algo, **regresa al anterior**. La base só
 
 ---
 
-**Siguiente**: [Módulo 1: Fundamentos de IA para Desarrolladores](./01-fundamentos.md)
+**Siguiente**: [Módulo 1: Fundamentos de IA para Desarrolladores](./01-fundamentos)
diff --git a/docusaurus.config.js b/docusaurus.config.js
@@ -4,7 +4,7 @@
 // There are various equivalent ways to declare your Docusaurus config.
 // See: https://docusaurus.io/docs/api/docusaurus-config
 
-import {themes as prismThemes} from 'prism-react-renderer';
+import { themes as prismThemes } from 'prism-react-renderer';
 
 // This runs in Node.js - Don't use client-side code here (browser APIs, JSX...)
 
@@ -85,11 +85,11 @@ const config = {
       image: 'img/codigo-sin-siesta-social-card.png',
       // Open Graph and Twitter Card metadata
       metadata: [
-        {property: 'og:image', content: 'img/codigo-sin-siesta-social-card.png'},
-        {property: 'og:type', content: 'website'},
-        {property: 'og:site_name', content: 'Código Sin Siesta'},
-        {name: 'twitter:card', content: 'summary_large_image'},
-        {name: 'twitter:image', content: 'img/codigo-sin-siesta-social-card.png'},
+        { property: 'og:image', content: 'img/codigo-sin-siesta-social-card.png' },
+        { property: 'og:type', content: 'website' },
+        { property: 'og:site_name', content: 'Código Sin Siesta' },
+        { name: 'twitter:card', content: 'summary_large_image' },
+        { name: 'twitter:image', content: 'img/codigo-sin-siesta-social-card.png' },
       ],
       colorMode: {
         respectPrefersColorScheme: true,
@@ -111,7 +111,7 @@ const config = {
             position: 'left',
             label: 'Documentación',
           },
-          {to: '/blog', label: 'Blog', position: 'left'},
+          { to: '/blog', label: 'Blog', position: 'left' },
           {
             href: 'https://github.com/codigosinsiesta',
             label: 'GitHub',

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1 @@`
	`1`	`+Subproject commit a79cfcd7256b0c11de5a795e79242b4d38f404fb`
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1 @@`
	`1`	`+Subproject commit 7b2885c63fc2a93ffc9b214584c43ba2e82b7ef2`
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1 @@`
	`1`	`+Subproject commit 903e44d74d131964cd53ceb8999bb007bd0d21a3`
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1 @@`
	`1`	`+Subproject commit 4cd731df7daa869d6cbd81ecf34908e7db7d4e79`