Relier un dépôt à l'éditeur de Docs

Un projet déployé avec la CLI n’a pas de dépôt connu de Host, donc l’éditeur de Docs ne sait pas où écrire ses pages. Relier le dépôt le lui indique, sans toucher au déploiement.

Résultat attendu : l’onglet Git du projet affiche Dépôt de l’éditeur, et l’éditeur de Docs ouvre la doc dans ce dépôt.

Avant de commencer : être administrateur de l’équipe, avoir installé l’app GitHub de Host (voir Déployer depuis GitHub), et avoir le droit d’écrire dans le dépôt.

Relier le dépôt

1. Ouvre l'onglet Git

   Dans le projet, ouvre l’onglet Git, section Relier un dépôt (éditeur seulement), puis Choisir un dépôt.

2. Choisis le dépôt

   La liste ne montre que les dépôts que l’app GitHub peut voir et où tu as le droit d’écrire.

3. Indique le dossier et la branche

   Dossier de la doc : celui qui contient docs.json, par exemple host. Branche de production : l’éditeur y publie.

4. Relie

   Clique sur Relier.

   Vérification : la section devient Dépôt de l’éditeur et rappelle le dépôt, le dossier et la branche.

Ce que Host ne fait pas

Host n’ajoute ni workflow, ni clé, ni pull request, et ne pose aucun statut sur les commits. Le projet continue de se déployer comme avant. Le dépôt ne sert qu’à l’éditeur de Docs.

Délier le dépôt

Dans la section Dépôt de l’éditeur, Délier retire le lien. Le dépôt et ses fichiers ne changent pas.

Un projet déjà importé depuis GitHub n’a pas besoin de cette étape : l’éditeur utilise déjà son dépôt.