Votre prose emménage avec la référence.

Un [lien](apidoc:createOrder) se rend en ligne avec le badge de méthode de l’opération et mène à sa documentation — par operationId ou par "MÉTHODE /chemin", webhooks compris. Un bloc de code listant des références devient une rangée de cartes d’opération : méthode, chemin, résumé, badge de dépréciation. Une référence introuvable s’affiche visiblement cassée plutôt que de devenir un lien mort.

Les callouts façon GitHub (> [!NOTE] jusqu’à [!CAUTION]) deviennent de vraies alertes — et se dégradent en simples citations partout ailleurs où vit votre Markdown. Des blocs de code adjacents deviennent des onglets, et un choix de langage suit le lecteur dans tous les groupes d’onglets de la page. Ni plugin, ni build : c’est le même fichier que GitHub sait afficher.

{{var}} se résout dans la prose depuis l’environnement que la console d’essai utilise déjà : un guide se rend donc avec l’URL de base du lecteur et son identifiant de tenant — et le bouton de copie d’un bloc copie ce qui a été résolu, parce que ce qu’on colle doit tourner. De la documentation personnalisée, sans serveur, sans compte et sans chaîne de rendu. Les valeurs sensibles sont la seule chose qui n’apparaît jamais : elles se rendent en pastille masquée, et la valeur n’atteint ni la page, ni le presse-papiers, ni l’index de recherche, ni aucun export — non pas caviardée après coup, jamais émise. Une variable sans valeur affiche une pastille qui ouvre le gestionnaire d’environnements, parce que la définir est la seule suite possible.

Toutes les requêtes vont vers `{{baseUrl}}`, authentifiées
avec votre clé :

```bash
curl -H "X-Tenant: {{tenant}}" {{baseUrl}}/pets
```

Chaque page de prose reçoit un sommaire qui suit votre défilement, une pagination précédent/suivant dans l’ordre de la nav, et sa place dans la palette Cmd+K : titres et corps sont indexés — paresseusement, à la première recherche, pour que les pages que personne ne cherche ne soient jamais téléchargées. Titres et corps acceptent des variantes par langue, et une page home: true prend la route d’accueil (la vue d’ensemble technique déplacée garde sa propre route). Marquez une page kind: "changelog" et ses versions se rendent en frise. La même prose voyage aussi avec les exports de la surface IA.

Pointez feedback.url vers un endpoint à vous et chaque page gagne une ligne « Cette page vous a-t-elle été utile ? ». Un clic envoie { "page": "pagination", "verdict": "up" } à votre serveur — le slug de la page et un pouce, rien d’autre. Laissez la clé de côté, comme elle est livrée, et la ligne n’existe pas. C’est la seule chose dans ApiGlow qui envoie jamais le geste d’un lecteur quelque part ; elle va où vous avez dit et nulle part ailleurs, et il n’y a aucun produit à nous au bout du fil pour le récolter.

{ "feedback": { "url": "https://example.com/docs-feedback" } }

Les cartes d’opération sont des liens vers la référence, pas des consoles d’essai embarquées — l’exécution des requêtes reste dans la console d’essai, par choix. Les groupes tiennent sur un niveau : un manifeste qui tente d’imbriquer plus profond est rejeté avec un avertissement en console, pas aplati en silence.