# Docs

Docs transforme un dossier de pages MDX en site de documentation. Tu écris dans ton dépôt, Host publie le site, et la console `docs.hgdc.ch` indexe ta doc pour l’assistant qui répond à tes visiteurs.

[Ta première doc](/docs/demarrer/premiere-doc/)

[Un dossier, un `docs.json` et une page. Le site tourne sur ton poste en quelques minutes.](/docs/demarrer/premiere-doc/)

[Mettre en ligne](/docs/demarrer/mettre-en-ligne/)

[Publier avec Host, créer le projet dans la console et poser une première question à l’assistant.](/docs/demarrer/mettre-en-ligne/)

[Guides](/docs/guides/ecrire-une-page/)

[Écrire une page, organiser la navigation, régler l’assistant, lire le journal.](/docs/guides/ecrire-une-page/)

[Référence](/docs/reference/docs-json/)

[Les champs de `docs.json`, les composants, la commande `hgdc-docs`, l’API et les limites.](/docs/reference/docs-json/)

## Ce que Docs fournit

- **Un site statique** : navigation par groupes, onglets et versions, mode clair et sombre, recherche intégrée au site. Rien ne tourne côté serveur pour l’afficher.
- **Ta couleur et ton logo** : une couleur dans `docs.json` suffit. Le contraste des liens est ajusté pour rester lisible.
- **Un assistant sourcé** : il répond à partir de ta doc seulement, cite les sections utilisées, et dit qu’il ne trouve pas quand la réponse n’y est pas.
- **Une doc lisible par les agents** : `llms.txt`, une version Markdown de chaque page et un serveur MCP en lecture seule.

## Compatible avec Mintlify

Le fichier `docs.json` reprend les champs de Mintlify : `name`, `colors`, `logo`, `favicon` et `navigation` en groupes, onglets ou versions. Les composants qui portent les mêmes noms (`Note`, `Steps`, `Card`, `Tabs`…) fonctionnent sans import. Le guide [Passer depuis Mintlify](/docs/guides/passer-depuis-mintlify/) liste les écarts.

## Les autres produits de la famille

[Account](https://account.hgdc.ch/docs/)

[![](/docs/images/famille/account.svg)](https://account.hgdc.ch/docs/)

[Un seul compte pour toute la famille, avec « Se connecter avec HGDC ».](https://account.hgdc.ch/docs/)

[Host](https://host.hgdc.ch/docs/)

[![](/docs/images/famille/host.svg)](https://host.hgdc.ch/docs/)

[Ton site en ligne, déployé à chaque modification.](https://host.hgdc.ch/docs/)

[Mail](https://mail.hgdc.ch/docs/)

[![](/docs/images/famille/mail.svg)](https://mail.hgdc.ch/docs/)

[Tes e-mails, newsletters et formulaires, envoyés depuis ton adresse.](https://mail.hgdc.ch/docs/)

[Portal](https://portal.hgdc.ch/docs/)

[![](/docs/images/famille/portal.svg)](https://portal.hgdc.ch/docs/)

[Un espace partagé où ton client suit son projet, signe et paie.](https://portal.hgdc.ch/docs/)

[Status](https://status.hgdc.ch/docs/)

[![](/docs/images/famille/status.svg)](https://status.hgdc.ch/docs/)

[Surveillance de tes services, heartbeats et page de statut.](https://status.hgdc.ch/docs/)

[Analytics](https://analytics.hgdc.ch/docs/)

[![](/docs/images/famille/analytics.svg)](https://analytics.hgdc.ch/docs/)

[Tes visiteurs mesurés, sans cookies ni bannière.](https://analytics.hgdc.ch/docs/)