Rapport SEO : analyse des slugs URL de la documentation

Généré depuis scripts/analyze-slug-seo.ts — source : scripts/slug-mapping.json (1 667 pages)

Locale de référence : fr — URL type : /fr/guides/{category}/{subcategory}/{slug}

1. Résumé exécutif

La majorité des slugs (65%) sont déjà excellents. Le finalSlug proposé améliore 475 entrées, principalement en supprimant la redondance avec le chemin URL et en désambiguïsant les slugs génériques. Aucune collision ne subsiste après traitement.

2. Méthodologie de scoring

Chaque entrée est notée sur 10 points, répartis en 5 critères de 2 points chacun. L'évaluation se fait sur l'URL localisée complète (ex: /fr/guides/public-cloud/compute/pre-installed-applications).

2.1 Longueur du slug (0-2 pts)

La longueur optimale d'un slug SEO est de 3-6 mots (15-50 caractères).

2.2 Descriptivité (0-2 pts)

Le slug doit contenir des mots-clés significatifs permettant à l'utilisateur et aux moteurs de recherche de comprendre le contenu de la page.

Liste des slugs génériques détectés : getting-started, faq, troubleshooting, billing, capabilities, concepts, overview, configuration, installation, maintenance, backups, advanced-configuration, responsibility-model, responsibility-sharing, lifecycle-policy.

2.3 Redondance avec le chemin URL (0-2 pts)

Les mots du slug qui apparaissent déjà dans les segments du chemin URL (/guides/public-cloud/compute/) sont redondants — ils n'apportent aucune information supplémentaire et rallongent inutilement l'URL.

Exemple : /fr/guides/public-cloud/containers-orchestration/managed-kubernetes/public-cloud-kubernetes-expose-applications-using-load-balancer → Les mots public, cloud, kubernetes sont déjà dans le chemin → 3/8 mots redondants (37.5%).

2.4 Unicité (0-2 pts)

Un slug identique utilisé pour plusieurs pages crée une ambiguïté pour le maillage interne et les backlinks.

2.5 Lisibilité de l'URL complète (0-2 pts)

Évalue la qualité globale de l'URL finale (/fr/guides/.../slug).

3. Distribution des scores

Score       Nombre   %       Barre
──────────────────────────────────────────
9-10  ████████████████████████████████  1 082  64.9%   Excellent
7-8   ████████████████                    496  29.7%   Bon
5-6   ███                                  89   5.3%   Acceptable
3-4                                         0   0.0%   Faible
0-2                                         0   0.0%   Critique

4. Problèmes détectés (flags)

Répartition par zone produit

Les flags url-too-long et redundant se concentrent fortement sur Public Cloud > Containers & Orchestration (Kubernetes, Rancher, Registry) où les fullSlug Pelican incluaient le chemin complet (public-cloud-kubernetes-..., public-cloud-managed-rancher-service-...) et la migration a ajouté une profondeur d'arborescence supplémentaire.

5. Logique du finalSlug

Le finalSlug est une proposition d'amélioration automatique du newSlug, calculée en 3 passes :

Passe 1 — Nettoyage (par entrée)

Appliquée uniquement si le score SEO est < 9 :

1. Strip de la redondance — Si le slug est flaggé redundant/highly-redundant ou n'a pas été strippé lors du mapping initial (newSlug === fullSlug), les mots du début du slug qui apparaissent dans les segments URL sont retirés séquentiellement.

   Chemin URL : /guides/public-cloud/containers-orchestration/managed-kubernetes/
   Mots du chemin : {public, cloud, containers, orchestration, managed, kubernetes}
   
   Slug : public-cloud-kubernetes-expose-applications-using-load-balancer
          ^^^^^^ ^^^^^ ^^^^^^^^^^  ← dans le chemin → strippés
   Résultat : expose-applications-using-load-balancer

   Garde-fou : au minimum 2 mots sont toujours conservés, et le résultat doit faire ≥ 3 caractères.

2. Strip du préfixe numérique — 00-global-reversibility → global-reversibility

3. Expansion des slugs trop courts — Si le slug fait ≤ 3 caractères ou est un mot unique < 6 caractères, il est préfixé par le nom du répertoire parent.

   ui    → secret-manager-ui
   use   → ssl-gateway-use
   svn   → web-hosting-svn

Passe 2 — Désambiguation simple

Si plusieurs entrées ont le même finalSlug après la passe 1, chacune est préfixée par son répertoire parent immédiat :

troubleshooting (dans backup-agent/)     → backup-agent-troubleshooting
troubleshooting (dans iam/)              → iam-troubleshooting
troubleshooting (dans quantum-computing/) → quantum-computing-troubleshooting

Passe 3 — Désambiguation profonde

Si une collision persiste après la passe 2 (deux pages dans le même répertoire), le fullSlug original est utilisé tel quel. Le fullSlug Pelican est garanti unique.

getting-started (web-hosting/, fullSlug: web-hosting-getting-started)       → web-hosting-getting-started
getting-started (web-hosting/, fullSlug: cloud-web-hosting-getting-started) → cloud-web-hosting-getting-started

6. Résultats finalSlug

Ventilation des améliorations

Note : certaines entrées cumulent plusieurs types d'amélioration. Le total des catégories peut dépasser 475.

7. Exemples d'améliorations par catégorie

7.1 Redondance strippée

Le slug répétait des mots déjà présents dans le chemin URL. Le finalSlug ne conserve que l'information discriminante.

7.2 Slugs trop longs réduits

Les slugs non strippés lors du mapping initial (le fullSlug Pelican ne matchait pas le pattern {category}-{subcategory}-) sont réduits par le stripping agressif basé sur les mots du chemin.

7.3 Slugs génériques désambiguïsés

Les slugs trop génériques sont préfixés par leur répertoire parent pour devenir descriptifs dans le contexte de l'URL et uniques à l'échelle du site.

7.4 Slugs trop courts étendus

Les slugs de 1 à 3 caractères ou mono-mot très court n'ont aucune valeur SEO isolée. Le contexte parent les rend compréhensibles.

8. Collisions newSlug et résolution

28 slugs newSlug sont partagés par 2 à 6 pages. Le finalSlug résout toutes les collisions.

Collisions les plus fréquentes

getting-started (6 pages)

troubleshooting (6 pages)

faq (3 pages)

Autres collisions (2-3 pages chacune)

9. 50 pires entrées

Les entrées avec le score SEO le plus bas, triées par score croissant. Quand un finalSlug est proposé, il est affiché.

Score 5.5 (7 entrées)

Toutes dans public-cloud/containers-orchestration/ — slugs non strippés très longs et redondants.

Score 6.0 (42 entrées)

Mélange de slugs génériques, trop courts, et longs non strippés.

Slugs génériques/trop courts :

Slugs longs (containers-orchestration) :

Non résolus automatiquement (score 6.0, pas d'amélioration) :

Score 6.5 (1 entrée notable)

10. Cas non résolus automatiquement

Certaines entrées conservent un score acceptable (6.0) mais n'ont pas été améliorées car le stripping automatique ne peut pas inventer de meilleur slug — le fullSlug Pelican lui-même est trop long ou non descriptif.

10.1 Slugs longs dans storage-and-backup/object-storage/

Le score est 6.0 avec le fullSlug original, mais les mots du path (storage, backup, object) ne matchent pas le début du slug (public-cloud-storage-...). Le mot cloud n'est pas dans le path storage-and-backup, et public est trop court (filtré à ≤ 2 chars dans la logique de stripping). Ces cas nécessiteraient un mapping manuel.

Slug idéal (manuel) : migrate-from-s3-to-ovhcloud, optimised-upload-method, migrate-from-swift-to-s3

10.2 Slugs encore longs après stripping

Certains finalSlug restent longs car le contenu est intrinsèquement détaillé. Le stripping a supprimé la redondance mais le slug reste > 40 chars.

Exemples :

• configure-multi-attach-persistent-volumes-enterprise-file-storage (65 chars)
• configure-multi-attach-persistent-volumes-cloud-disk-array (58 chars)
• deploy-monitoring-prometheus-grafana-metrics (45 chars)

Ces cas sont acceptables — le slug est descriptif et non redondant. Un raccourcissement supplémentaire perdrait de l'information.

11. Recommandations

Action immédiate — Appliquer les finalSlug

Les 475 finalSlug améliorés sont prêts à être utilisés pour le renommage MDX (étape 2 du plan). Zéro collision, améliorations déterministes et réversibles.

Mapping manuel — 3-5 entrées

Les ~3 entrées storage-and-backup/object-storage/ scorant 6.0 sans amélioration automatique bénéficieraient d'un slug raccourci manuellement (voir section 10.1).

Priorité de renommage par impact SEO

Redirections 301

Chaque renommage MDX nécessitera une redirection 301 de l'ancien slug vers le nouveau pour préserver le jus SEO existant et éviter les 404 sur les backlinks.

Fichiers générés