Blume 2.0 refond la configuration de la documentation en adaptateurs modulaires, introduit des réglages de découverte pour agents et ajoute des outils de mise à niveau automatisés.
Fonction du produit et positionnement officiel
Blume 2.0 est une version majeure du framework de documentation qui restructure la configuration du site tout en préservant le contenu Markdown et MDX existant. Cette mise à jour remplace les anciennes options textuelles et les blocs imbriqués par des adaptateurs typés importés depuis des sous-chemins spécialisés couvrant les hôtes de déploiement, les moteurs de recherche, les sources de contenu, les outils analytiques, les références d'API et les backends d'assistants IA.
La version modernise également la découvrabilité en organisant les métadonnées IA lisibles par machine, les configurations du protocole Model Context Protocol et les compétences au sein d'un espace de noms dédié agents. Les projets peuvent automatiser leur migration à l'aide d'une commande de mise à niveau interactive en ligne de commande, compatible avec des agents de codage automatisés tels que Codex et Claude Code.
Cas d’usage étayés par les sources officielles
Les équipes de développement peuvent mettre à niveau leurs dépôts de documentation existants en exécutant la CLI de mise à niveau pour repérer les paramètres obsolètes, adapter les surcharges de composants et mettre à jour les schémas de configuration.
Les organisations peuvent regrouper de la documentation issue de dépôts locaux, d'espaces Notion, de Sanity, de GitHub Releases et de schémas d'API au sein d'un site de documentation unifié, généré de façon statique ou rendu côté serveur.
Le parcours documenté, lorsqu’il est disponible
Lancez la CLI de mise à niveau depuis la racine du projet pour incrémenter la version du paquet et analyser les fichiers de configuration à la recherche des modifications requises.
Convertissez les blocs de recherche, de déploiement, de sources de contenu, de références d'API, d'analytique et d'assistants dans blume.config.ts en appels de fonctions d'adaptateurs importés.
Déplacez les fonctions en ligne et les déclarations internes de components.ts vers des fichiers distincts, puis importez-les sous forme de références de composants discrètes.
Exécutez les commandes CLI doctor et build pour vous assurer que tous les paramètres de configuration et liaisons de composants passent la validation sans aucune erreur.
Blume 2.0 fait évoluer son architecture vers des adaptateurs modulaires pour chaque point d'intégration fonctionnel. Au lieu de définir des chaînes pour les fournisseurs et des blocs d'identifiants dans blume.config.ts, les développeurs importent des fonctions d'adaptateurs dédiées à partir de sous-chemins spécialisés comme blume/search, blume/deploy, blume/sources, blume/reference, blume/analytics et blume/ai. Cette architecture permet de déclarer explicitement des rendus adaptés aux hébergeurs pour des plateformes comme Vercel, Netlify, Cloudflare et Node.js, supprimant ainsi la détection implicite du serveur au moment de l'exécution et les options de compilation obsolètes en ligne de commande.
Afin de simplifier l'adoption, Blume 2.0 intègre un flux de mise à niveau automatisé via la CLI. L'exécution de l'utilitaire de mise à niveau inspecte blume.config.ts, components.ts et les scripts du package, indiquant les emplacements exacts des fichiers ainsi que les remplacements à effectuer pour les configurations obsolètes. L'outil peut également faire appel à des agents de codage comme Codex ou Claude Code afin de résoudre de manière interactive les conclusions de la migration avant de vérifier le site à l'aide des diagnostics intégrés de doctor et build.
Vérifications à effectuer avec vos contenus et votre flux de travail
Sources vérifiées et date de la vérification
Réponses fondées sur la fiche produit dont les sources ont été vérifiées
Les pages Markdown et MDX ne nécessitent aucune modification lors de la mise à niveau, car Blume 2.0 fait évoluer la syntaxe de configuration plutôt que la structure du contenu des pages.
Le champ search.boost du frontmatter, qui était ignoré dans Blume 1, est désormais actif et applique directement un coefficient multiplicateur au classement de pertinence de recherche pour la page.
Lancer la commande de mise à niveau avec l'option codex ou claude ouvre une session d'agent interactive afin d'appliquer automatiquement les corrections de configuration requises.
Toutes les entrées de composants doivent désormais être des composants importés, des chemins de fichiers ou des objets descripteurs de composants spécifiques, les fonctions en ligne et les déclarations internes étant interdites.
Les blocs de référence individuels sont remplacés par un tableau unifié reference alimenté par des fonctions d'adaptateurs pour OpenAPI, AsyncAPI, GraphQL et Scalar.
