Corriger les liens brisés

jamdesk fix est le compagnon de correction automatique de jamdesk broken-links. Il lit les mêmes avertissements de liens brisés et réécrit tout fichier dont la cible correcte peut être déterminée de manière non ambiguë. Les cas ambigus sont signalés pour révision manuelle et laissés intacts.

Il corrige deux types de liens internes brisés :

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

Étape 1 : Trouver les liens brisés

Exécutez jamdesk broken-links pour voir ce qui nécessite une correction :

jamdesk broken-links

Examinez le résultat. jamdesk fix cible les avertissements pour lesquels une ancre correcte probable 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 toucher des fichiers :

jamdesk fix --dry-run

Exemple de sortie :

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 planifiée. Si une modification ne semble pas correcte, corrigez ce lien manuellement plutôt que de l'appliquer — jamdesk fix ne réécrit que les liens qu'il peut résoudre de manière non ambiguë.

É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 la confirmation dans un pipeline CI ou un script, 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 le laisse intact pour que vous le résolviez manuellement.

Étape 4 : Réviser le diff et valider

Vérifiez les modifications avant de valider :

git diff

Assurez-vous que chaque lien réécrit pointe bien là où vous l'attendez. Puis validez :

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

Options

Prochaines étapes