docs(site): une section « Cas d'usage », et une chose entière dedans

[gplanchat]

Pourquoi

Les dix-sept sections de documentation/user/ sont toutes de la référence de fonctionnalité : await ici, les signaux là, Nexus plus loin. Il n'existe aucun créneau pour « voici une chose entière construite avec Durable ».

Conséquence, mesurée avant d'écrire quoi que ce soit :

• seize scénarios sous symfony/src/Samples/Workflow/, portés de temporalio/samples-php — mentionnés nulle part sur le site ;
• la maquette Nexus à quatre applications — trois frameworks, quatre namespaces — enterrée dans un paragraphe de nexus/.

Cette PR ouvre le créneau. Elle ne construit pas un contenant pour du contenu espéré : elle en construit un pour du contenu déjà écrit qui n'a pas d'adresse.

Ce qu'il y a dedans

use-cases/_index	ce qu'est une entrée, et les cinq choses qu'une page doit dire — dont « ce qui n'est pas prouvé », sans quoi c'est une brochure
use-cases/nexus-demo	quatre applications qui s'appellent : ce que Durable apporte, et que l'ordre des appels est la seule compensation qu'il y ait

Une entrée, pas deux

L'entrée sur l'agent IA interruptible a été retirée en cours de route, et c'est le point qui mérite d'être lu.

Elle décrivait un convertisseur écrit à la main et un pont fournisseur absent. Les deux sont devenus faux : le spike a fusionné spike/agent-questionnaires, le convertisseur maison est supprimé au profit du vrai pont Mistral — et ce pont refuse par un 422 (Extra inputs are not permitted) le reasoning_content que la page présentait comme la forme du raisonnement.

Elle n'avait de toute façon pas de chemin de lancement, ce que son propre avertissement disait. Une entrée qui renvoie vers quelque chose qu'on ne peut pas démarrer n'est pas une entrée — c'est la règle que le _index de la section pose lui-même. Elle reviendra quand son prototype sera posé.

Les seize scénarios de Samples/ restent dehors aussi : ce sont des vignettes de fonctionnalité, pas des applications entières. Les faire entrer parce que les deux manquent serait la mauvaise raison.

Sur le nom

« Cas d'usage » et pas « Advanced use cases » : l'adjectif décrit une difficulté, alors que la propriété qui distingue ces entrées est la complétude. La maquette Nexus n'est pas difficile — elle est entière. Et « advanced » décourage.

Vérification

Première section du guide à avoir des sous-pages : les dix-sept autres sont un _index plat. Vérifié sur un build --minify servi en HTTP (public/ et file:// mentent) :

• la nav imbrique les enfants sous la section, dans l'ordre des poids, y compris depuis une autre page ;
• la section arrive en dernier (poids 45), après Testing ;
• la table des matières est complète — les sept h2, accents compris ;
• les tableaux rendent, les liens croisés relatifs résolvent, dans les deux langues ;
• /docs/use-cases/ et /fr/docs/use-cases/ répondent 200, enfant compris.

Un correctif que le build a signalé : le shortcode hint du thème est déprécié en Hugo 0.165. Les avertissements passeraient par les alertes Markdown (> [!WARNING]), que le thème habille toujours en book-hint warning — vérifié avant que la page concernée ne soit retirée. Aucune autre page ne l'utilisait.

Hors périmètre

• La consolidation du paragraphe démo de nexus/ avec la nouvelle entrée — nexus/ n'est pas touché.
• Une page de catalogue pour les seize scénarios.
• Tout ce qu'un showcase communautaire demanderait : règles de soumission, gabarit de contribution, mise en page de galerie. Le modèle de données de la section est déjà celui d'un showcase ; il n'y a rien à construire avant que quelqu'un se présente.