02 — Créer un dépôt

Un dépôt correspond à un projet. Créez-en un par projet, pas un par fichier.

Étapes

1. Cliquez sur + en haut à droite → Nouveau dépôt.
2. Propriétaire — vous-même, ou une organisation dont vous êtes membre.
3. Nom du dépôt — en minuscules, sans espaces : network-lab, web-site, guide.
4. Description — une ligne expliquant de quoi il s'agit. Elle apparaît dans les résultats de recherche.
5. Visibilité
• Public — toute personne pouvant atteindre le serveur peut lire.
• Privé — seulement vous et les personnes que vous invitez.
6. Initialiser le dépôt — cochez la case. Cela crée le premier commit avec un README.md, le dépôt est donc utilisable tout de suite.
7. Cliquez sur Créer le dépôt.

De bons noms

Les espaces et les parenthèses dans les noms compliquent le partage de liens et peuvent perturber les chemins relatifs à l'intérieur des documents. Minuscules, chiffres et tirets sont toujours sûrs.

Après la création

• Paramètres → Collaborateurs — donner un accès en lecture ou en écriture à d'autres personnes.
• Paramètres → Branches — protéger main pour que personne n'y commite directement.
• Ajouter un fichier — commencer à remplir le dépôt (chapitre 03).

Supprimer un dépôt

Paramètres → Zone de danger → Supprimer ce dépôt. Vous devez taper le nom du dépôt pour confirmer. C'est irréversible — l'historique disparaît avec lui.