Corriger les liens rompus

jamdesk fix est le compagnon de correction automatique de jamdesk broken-links. Il lit les mêmes avertissements de liens rompus et réécrit tout fichier pour lequel la cible correcte peut être déterminée sans ambiguïté. Les cas ambigus sont signalés pour une révision manuelle et laissés inchangés.

Il corrige deux types de liens internes rompus :

• Ancres mal orthographiées — un fragment qui est une faute de frappe évidente d'un titre réel sur la page cible (par exemple #instalation → #installation)
• Dérive d'ancre inter-locale — une page traduite a renommé ses titres, mais les liens dans cette locale pointent toujours vers l'ancien fragment anglais (par exemple /fr/ai/selectors#ai-strategies → /fr/ai/selectors#stratégies-ia)

Étape 1 : Trouver les liens rompus

Exécutez jamdesk broken-links pour voir ce qui doit être corrigé :

jamdesk broken-links

Examinez le résultat. jamdesk fix cible les avertissements pour lesquels une ancre probablement correcte peut être associée à un titre réel.

Étape 2 : Prévisualiser les corrections

Exécutez avec --dry-run pour voir exactement ce qui changerait avant de modifier le moindre fichier :

jamdesk fix --dry-run

Exemple de résultat :

Planned fixes:

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

(dry run — no files written)

Vérifiez chaque correction prévue. Si un changement ne semble pas correct, corrigez ce lien manuellement plutôt que d'appliquer la modification. jamdesk fix ne réécrit que les liens qu'il peut résoudre sans ambiguïté.

Étape 3 : Appliquer les corrections

Exécutez sans --dry-run pour appliquer. Une confirmation vous sera demandée :

jamdesk fix

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

Appuyez sur y pour écrire les modifications. Pour ignorer l'invite en CI ou dans des scripts, utilisez -y :

jamdesk fix -y

Après application, la commande affiche :

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

Si la cible d'un avertissement est ambiguë, jamdesk fix la laisse inchangée pour que vous la résolviez manuellement.

Étape 4 : Vérifier le diff et valider

Vérifiez les modifications avant de valider :

git diff

Vérifiez que chaque lien réécrit pointe vers l'endroit attendu. Puis validez :

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

Options

Et ensuite ?