À propos des dépôts
Un référentiel est l’élément le plus simple de GitHub. Il s’agit d’un endroit où vous pouvez stocker votre code, vos fichiers et l’historique de révision de chaque fichier. Les référentiels peuvent avoir plusieurs collaborateurs, et peuvent être publics ou privés.
Pour créer un référentiel, allez sur https://github.com/new. Pour les instructions, consultez Guide de démarrage rapide pour les dépôts.
Terminologie du référentiel
Avant de démarrer avec les référentiels, découvrez ces termes importants.
| Terme | Définition |
|---|---|
| Branche | Une version parallèle de votre code contenue dans le référentiel, mais qui n’affecte pas la branche primaire ou principale. |
| Cloner | Pour télécharger une copie complète des données d’un référentiel à partir de GitHub.com, y compris toutes les versions de chaque fichier et dossier. |
| Duplication (fork) | Un nouveau référentiel qui partage le code et les paramètres de visibilité avec le référentiel « en amont » d’origine. |
| Fusionner (Merge) | Pour récupérer les modifications d’une branche et les appliquer à une autre. |
| Demande de tirage (pull request) | Une demande de fusion des modifications d’une branche vers une autre. |
| Remote | Un référentiel stocké sur GitHub et non sur votre ordinateur. |
| En amont | La branche sur un référentiel d’origine qui a été dupliquée ou clonée. La branche correspondante sur la branche clonée ou dupliquée est appelée « en aval ». |
À propos de la propriété du référentiel
Vous pouvez posséder des référentiels individuellement ou partager la propriété des référentiels avec d’autres personnes d’une organisation.
Dans les deux cas, l’accès aux référentiels est géré par des autorisations. Pour plus d’informations, consultez « Niveaux d’autorisation pour un référentiel de compte personnel » et « Rôles de dépôt pour une organisation ».
Présentation la collaboration
Vous pouvez utiliser des référentiels pour gérer votre travail et collaborer avec d’autres personnes.
- Vous pouvez utiliser des problèmes pour collecter des commentaires d’utilisateurs, signaler des bogues logiciels et organiser les tâches que vous souhaitez accomplir. Pour plus d’informations, consultez À propos des problèmes.
- Vous pouvez utiliser GitHub Discussions pour poser des questions et y répondre, partager des informations, faire des annonces et participer à des conversations sur un projet. Pour plus d’informations, consultez « À propos des discussions ».
- Vous pouvez utiliser des demandes de tirage pour proposer des modifications d’un référentiel. Pour plus d’informations, consultez « À propos des demandes de tirage (pull requests) ».
- Vous pouvez utiliser Projects pour organiser et classer par ordre de priorité vos problèmes et demandes de tirage (pull request). Pour plus d’informations, consultez « À propos des Projects ».
Avec GitHub Free pour les comptes personnels et les organisations, vous pouvez travailler avec un nombre illimité de collaborateurs sur un nombre illimité de dépôts publics avec un ensemble complet de fonctionnalités ou sur un nombre illimité de dépôts privés avec un ensemble limité de fonctionnalités. Pour obtenir des outils avancés pour les dépôts privés, vous pouvez effectuer une mise à niveau vers GitHub Pro, GitHub Team ou GitHub Enterprise Cloud. Pour plus d’informations, consultez « Plans de GitHub ».
À propos de la visibilité du référentiel
Vous pouvez restreindre les utilisateurs ayant accès à un dépôt en choisissant la visibilité d’un dépôt : public ou privé.
Lorsque vous créez un dépôt, vous pouvez choisir de le rendre public ou privé. Les dépôts dans les organisations qui utilisent GitHub Enterprise Cloud et qui appartiennent à un compte d’entreprise peuvent également être créés avec une visibilité interne. Pour plus d'informations, consultez la documentation GitHub Enterprise Cloud.
- Les référentiels publics sont accessibles à tous sur Internet.
- Les dépôts privés ne sont accessibles que par vous, les personnes avec lesquelles vous partagez explicitement l’accès et, pour les référentiels d’organisation, certains membres de l’organisation.
Les propriétaires d’organisation ont toujours accès à chaque référentiel créé dans une organisation. Pour plus d’informations, consultez « Rôles de dépôt pour une organisation ».
Les personnes disposant d’autorisations d’administrateur pour un référentiel peuvent modifier la visibilité d’un référentiel existant. Pour plus d’informations, consultez « Définition de la visibilité du dépôt ».
Étapes suivantes
Voici quelques ressources utiles pour aller plus loin avec les référentiels.
- Meilleures pratiques pour les référentiels : découvrez comment utiliser les référentiels le plus efficacement possible.
- Création d’un dépôt : créez un référentiel.
- Création et suppression de branches dans votre référentiel : découvrez comment créer et supprimer des branches dans votre référentiel.
- Création d’une demande de tirage : créez une demande de tirage (pull request) pour proposer et collaborer sur des modifications apportées à un référentiel.