# Ardo vs Nimbus

Comparez les méthodes de documentation React et Astro, la propriété de l’interface, les références API, les services pour agents et les migrations.

Source: https://ardo-docs.dev/fr/compare/nimbus

Ardo et Nimbus conservent la documentation dans votre dépôt et publient du HTML statique ainsi que du Markdown pour les agents. Le choix dépend surtout du modèle de composants, de la maintenance des fichiers d’interface et du type de référence API nécessaire.

Vérifié le **10 novembre 2026** avec les versions publiées **Ardo 6.5.0**, **Nimbus 0.19.4** et le **générateur Nimbus 0.8.3**. Les sources Nimbus ci-dessous sont figées au [commit de publication 0.19.4](https://github.com/cloudflare/nimbus/tree/980cee6da75f81982552b68a3607c0a19ee11987), sans utiliser le main non publié. La référence Ardo est son [tag 6.5.0](https://github.com/sebastian-software/ardo/tree/ardo-v6.5.0).

## Quelle méthode vous convient ? {#which-workflow-fits}

Choisissez Ardo si la documentation et les exemples doivent partager un modèle de composants React, si l’API provient de TypeScript et si vous préférez mettre à jour une interface distribuée en paquet. Des composants racine et des layouts React personnalisés restent possibles.

Choisissez Nimbus si posséder les fichiers de layouts, de composants et de styles est essentiel à votre travail, ou si vous avez besoin de sa référence OpenAPI plus étendue et de services optionnels pour agents côté serveur. Sa [structure de projet](https://github.com/cloudflare/nimbus/blob/980cee6da75f81982552b68a3607c0a19ee11987/apps/www/src/content/docs/project-structure.mdx) sépare vos fichiers de la dépendance au framework ; les mises à jour n’écrasent pas simplement votre site.

## Comparaison des fonctionnalités {#feature-comparison}

| Domaine | Ardo 6.5.0 | Nimbus 0.19.4 |
| --- | --- | --- |
| Modèle de page | Pages React et MDX, prérendues puis hydratées ; navigation classique entre documents. | Pages Astro et MDX. Les composants de framework interactifs utilisent les [îlots Astro](https://docs.astro.build/en/concepts/islands/). |
| Propriété de l’interface | L’interface est fournie par le paquet ; composez-la ou remplacez-la avec React. | Les layouts, composants et styles générés résident dans [votre dépôt](https://github.com/cloudflare/nimbus/blob/980cee6da75f81982552b68a3607c0a19ee11987/apps/www/src/content/docs/project-structure.mdx). |
| Référence API | Référence TypeScript native et générateur statique OpenAPI local. | [OpenAPI 3.x](https://github.com/cloudflare/nimbus/blob/980cee6da75f81982552b68a3607c0a19ee11987/apps/www/src/content/docs/api-reference/index.mdx), avec opérations, schémas, versions d’API et interface de référence dédiés. |
| Langages | Arborescences statiques complètes par langue ; les quatre langues de ce site utilisent des catalogues Palamedes. | Nimbus expose une langue de document pour le site ; le routage linguistique et la traduction relèvent du [projet Astro](https://github.com/cloudflare/nimbus/blob/980cee6da75f81982552b68a3607c0a19ee11987/packages/nimbus-docs/src/types.ts). |
| Gestion des versions | Instantanés statiques par version majeure ; les répertoires de guides/API peuvent être versionnés indépendamment des pages du site. | Collections et chemins distincts pour les [anciennes versions de documentation](https://github.com/cloudflare/nimbus/blob/980cee6da75f81982552b68a3607c0a19ee11987/apps/www/src/content/docs/navigation/versioning.mdx) ; les versions d’API ont leur propre modèle. |
| Recherche | MiniSearch intégré avec index générés. | [Recherche Pagefind](https://github.com/cloudflare/nimbus/blob/980cee6da75f81982552b68a3607c0a19ee11987/apps/www/src/content/docs/navigation/search.mdx) statique, ou fournisseur défini par le projet. |
| Fichiers pour agents | Markdown par page, llms.txt, llms-full.txt et découverte optionnelle des Agent Skills. | [Markdown et llms.txt](https://github.com/cloudflare/nimbus/blob/980cee6da75f81982552b68a3607c0a19ee11987/apps/www/src/content/docs/ai/publish-markdown.mdx), avec des services optionnels pour les agents. |
| MCP | Pas de point d’accès MCP à l’exécution fourni par le framework. | [MCP distant](https://github.com/cloudflare/nimbus/blob/980cee6da75f81982552b68a3607c0a19ee11987/apps/www/src/content/docs/ai/remote-mcp.mdx) optionnel : list\_pages et get\_page ; nécessite un adaptateur serveur et le SDK. |
| Vérification et lint | ardo check sans build, ardo lint pour la rédaction et vérification des liens internes au build. | [nimbus-docs check et lint](https://github.com/cloudflare/nimbus/blob/980cee6da75f81982552b68a3607c0a19ee11987/apps/www/src/content/docs/cli.mdx), avec corrections et vérifications des mises à niveau. |
| Recettes | ardo add affiche des recettes adaptées à la version, sans écrire de fichiers. | [add](https://github.com/cloudflare/nimbus/blob/980cee6da75f81982552b68a3607c0a19ee11987/apps/www/src/content/docs/cli.mdx) copie le code des composants ; les fonctionnalités transmettent des recettes à un agent. |
| JavaScript dans le navigateur | Hydratation React et interface interactive ; pas de routeur client. | Îlots Astro avec les composants et scripts choisis ; le volume transféré dépend de cet assemblage. |
| Hébergement | Fichiers statiques sur tout hébergement statique. | [Statique par défaut](https://github.com/cloudflare/nimbus/blob/980cee6da75f81982552b68a3607c0a19ee11987/apps/www/src/content/docs/deploy/other-hosts.mdx) ; le rendu à la demande et MCP distant nécessitent un adaptateur serveur. |

Le [guide API](<https://ardo-docs.dev/v6/fr/guide/api-documentation/>), la [configuration](<https://ardo-docs.dev/v6/fr/guide/configuration/>), l’[internationalisation](<https://ardo-docs.dev/v6/fr/guide/internationalization/>) et les [instructions pour agents](<https://ardo-docs.dev/v6/fr/guide/agent-instructions/>) d’Ardo détaillent sa partie du tableau. Nimbus est antérieur à la version 1.0 ; consultez ses notes de version avant de supposer qu’une version mineure ultérieure se comporte de la même manière.

## Venir de Nimbus {#coming-from-nimbus}

| Projet Nimbus | Équivalent Ardo ou travail de migration |
| --- | --- |
| src/content/docs/ | Déplacez les textes dans app/routes/, avec les répertoires de langue et guide selon la configuration. Préservez les anciennes URL par des redirections explicites. |
| title, description, sidebar.order | Conservez title et description ; remplacez sidebar.order par order. Vérifiez les autres champs de [frontmatter](<https://ardo-docs.dev/v6/fr/guide/frontmatter/>) individuellement. |
| mode: custom | Utilisez layout: bare pour une page sans cadre de documentation. |
| src/components.ts et composants Astro | Vérifiez chaque composant et ses props ; portez le code Astro vers React ou utilisez les composants MDX d’Ardo. La conversion des composants n’est pas automatique. |
| astro.config.ts et nimbus() | Utilisez ardo.config.ts pour les options du framework et les plugins Vite personnalisés, et app/root.tsx pour composer l’interface. |
| Références OpenAPI | Commencez par la configuration openapi locale d’Ardo. Les versions d’API, vues de schémas et commandes interactives de référence de Nimbus ne se transposent pas directement. |

Vérifiez les brouillons, les pages masquées et les règles de publication avant de déplacer le contenu ; les indicateurs Nimbus ne conservent pas automatiquement leur sens dans Ardo. Suivez les [instructions d’installation](<https://ardo-docs.dev/v6/fr/guide/agent-instructions/>) et vérifiez les routes publiées, les liens et les exemples dans un aperçu de production.

## Limites et travaux en cours {#gaps-and-current-work}

Nimbus prend aussi en charge les [sources de contenu Git](https://github.com/cloudflare/nimbus/blob/980cee6da75f81982552b68a3607c0a19ee11987/apps/www/src/content/docs/content-sources/git.mdx) et les [builds partiels](https://github.com/cloudflare/nimbus/blob/980cee6da75f81982552b68a3607c0a19ee11987/apps/www/src/content/docs/publish/partial-builds.mdx). Les propositions correspondantes pour Ardo restent [#473](https://github.com/sebastian-software/ardo/issues/473) et [#474](https://github.com/sebastian-software/ardo/issues/474). Un checkout dans la CI suivi d’un mappage de contenu local est déjà possible.

Les composants de rédaction, les commandes check/lint, le rendu Mermaid statique et les recettes d’Ardo sont déjà implémentés : [#469](https://github.com/sebastian-software/ardo/issues/469), [#470](https://github.com/sebastian-software/ardo/issues/470), [#472](https://github.com/sebastian-software/ardo/issues/472) et [#475](https://github.com/sebastian-software/ardo/issues/475). Les images de partage automatiques des pages sont suivies dans [#471](https://github.com/sebastian-software/ardo/issues/471) ; elles ne font pas partie de la version publiée 6.5.0 utilisée ici.
