Aller au contenu principal

Supprimer une page de documentation

Voir aussi le glossaire Docusaurus pour les notions comme doc ID, sidebar, breadcrumb ou broken link.

Avant de supprimer​

Posez-vous ces questions :

  • D'autres pages contiennent-elles des liens vers cette page ?
  • Cette page est-elle liée depuis un fichier index.md ?
  • Est-elle référencée dans le blog ou une page custom (src/pages/) ?

Si oui, il faut d'abord nettoyer ces références avant de supprimer.

Étape 1 — Trouver tous les liens qui pointent vers cette page​

Dans VS Code, utilisez la recherche globale (Ctrl+Shift+F) et cherchez le nom du fichier sans extension.

Exemple : pour supprimer docs/vcf-automation/09_limitations_kb.md, cherchez :

09_limitations_kb

Notez tous les fichiers qui contiennent cette référence — ce sont eux à modifier.

Étape 2 — Supprimer ou mettre à jour les liens entrants​

Pour chaque fichier trouvé à l'étape 1, faites l'une des actions suivantes :

Option A — Supprimer le lien​

<!-- Avant -->
Pour plus de détails, voir les [Limitations & KBs](./09_limitations_kb.md).

<!-- Après -->
<!-- Ligne supprimée -->

Option B — Rediriger vers une autre page​

<!-- Avant -->
[Limitations & KBs](./09_limitations_kb.md)

<!-- Après -->
[Limitations & KBs](./08_testing_validation.md)

Étape 3 — Supprimer l'entrée dans sidebars.js​

Ouvrez sidebars.js et supprimez la ligne correspondant à la page dans la sidebar :

// Avant
items: [
  { type: 'doc', id: 'vcf-automation/08_testing_validation', label: '08 — Tests & Validation' },
  { type: 'doc', id: 'vcf-automation/09_limitations_kb',     label: '09 — Limitations & KBs' },
],

// Après
items: [
  { type: 'doc', id: 'vcf-automation/08_testing_validation', label: '08 — Tests & Validation' },
],

Attention : ne pas oublier la virgule sur la ligne précédente si vous supprimez la dernière entrée d'une liste.

Étape 4 — Supprimer le fichier​

Supprimez le fichier .md dans docs/.

Étape 5 — Vérifier dans le navigateur​

Si le serveur local tourne (npm run start), vérifiez que :

  • La page n'apparaît plus dans la sidebar
  • Aucune autre page ne mène vers une 404 à l'emplacement supprimé
  • Le build ne génère pas d'erreur (npm run build)

Conseil : lancez npm run build avant de pousser vos modifications. Docusaurus signale tous les broken links à la compilation.