Corregir enlaces rotos

jamdesk fix es el complemento de corrección automática de jamdesk broken-links. Lee los mismos avisos de enlaces rotos y reescribe cualquier archivo cuyo destino correcto pueda determinarse de forma no ambigua. Los casos ambiguos se marcan para revisión manual y se dejan sin tocar.

Corrige dos tipos de enlaces internos rotos:

• Anclas con erratas — un fragmento que es un error ortográfico claro de un título real en la página de destino (p. ej. #instalation → #installation)
• Desfase de ancla entre idiomas — una página traducida renombró sus títulos, pero los enlaces en ese idioma siguen apuntando al fragmento inglés antiguo (p. ej. /fr/ai/selectors#ai-strategies → /fr/ai/selectors#stratégies-ia)

Paso 1: Encontrar los enlaces rotos

Ejecuta jamdesk broken-links para ver qué necesita corrección:

jamdesk broken-links

Revisa el resultado. jamdesk fix actúa sobre los avisos donde se puede asociar un ancla correcta probable a un título real.

Paso 2: Previsualizar las correcciones

Ejecuta con --dry-run para ver exactamente qué cambiaría antes de tocar ningún archivo:

jamdesk fix --dry-run

Ejemplo de salida:

Planned fixes:

  fr/ai/overview.mdx:9
    /fr/ai/selectors#ai-strategies  →  /fr/ai/selectors#stratégies-ia

(dry run — no files written)

Comprueba cada corrección planificada. Si algún cambio no parece correcto, corrige ese enlace a mano en lugar de aplicarlo — jamdesk fix solo reescribe los enlaces que puede resolver de forma no ambigua.

Paso 3: Aplicar las correcciones

Ejecuta sin --dry-run para aplicar. Se te pedirá confirmación:

jamdesk fix

Apply 1 fix(es) to local files? (y/N)

Pulsa y para escribir los cambios. Para omitir la confirmación en CI o en scripts, usa -y:

jamdesk fix -y

Después de aplicar, el comando muestra:

Fixed 1 file(s); 0 warning(s) left for manual review.

Si el destino de un aviso es ambiguo, jamdesk fix lo deja intacto para que lo resuelvas a mano.

Paso 4: Revisar el diff y confirmar

Comprueba los cambios antes de confirmar:

git diff

Verifica que cada enlace reescrito apunta donde esperas. Luego confirma:

git add -A
git commit -m "fix(docs): auto-fix broken internal links"

Opciones

¿Qué sigue?