Ce guide vous aidera à créer votre compte et à utiliser les fonctionnalités de collaboration et de communauté de .
Les premières étapes pour commencer avec sont de créer un compte, de choisir un produit qui correspond le mieux à vos besoins, de vérifier votre email, de configurer l'authentification à deux facteurs et de consulter votre profil.
Il existe plusieurs types de comptes sur . Chaque personne qui utilise a son propre compte personnel, qui peut faire partie de plusieurs organisations et équipes. Votre compte personnel est votre identité sur .com, et vous représente en tant qu’individu.
Pour vous inscrire à un compte, accédez à https://.com/ et suivez les invites.
Pour assurer la sécurité de votre compte , vous devez utiliser un mot de passe fort et unique. Pour plus d’informations, consultez « Création d’un mot de passe fort ».
Vous pouvez choisir Free ou Pro pour avoir accès à différentes fonctionnalités pour votre compte personnel. Vous pouvez effectuer une mise à niveau à tout moment si vous n’êtes pas certain du produit souhaité.
Pour plus d'informations sur tous les projets de , voir Plans de .
Pour vous assurer que vous pouvez utiliser toutes les fonctionnalités de votre plan , vérifiez votre adresse e-mail après vous être inscrit pour un nouveau compte. Pour plus d’informations, consultez « Vérification de votre adresse e-mail ».
Une authentification à deux facteurs, ou 2FA, est une couche supplémentaire de sécurité utilisée lors de la connexion à des sites web ou à des applications. Nous vous recommandons vivement de configurer 2FA pour la sécurité de votre compte. Pour plus d’informations, consultez « À propos de l’authentification à deux facteurs ».
Si vous le souhaitez, une fois que vous avez configuré 2FA, ajoutez une clé d’accès à votre compte pour activer une connexion sécurisée sans mot de passe. Consultez Gestion de vos clés d'accès.
Votre profil raconte l'histoire de votre travail à travers les référentiels et les gists que vous avez épinglés, les adhésions à des organisations que vous avez choisi de rendre publiques, les contributions que vous avez apportées et les projets que vous avez créés. Pour plus d’informations, consultez « À propos de votre profil » et « Affichage des contributions sur votre profil ».
Pour utiliser au mieux , vous devez configurer Git. Git est responsable de tout ce qui est lié à qui se produit localement sur votre ordinateur. Pour collaborer efficacement sur , vous écrirez dans les issues et les pull requests en utilisant Markdown aromatisé.
L'approche collaborative du développement de dépend de la publication des commits de votre référentiel local sur pour que d'autres personnes puissent les voir, les récupérer et les mettre à jour à l'aide de Git. Pour plus d’informations sur Git, consultez le guide Manuel Git. Pour plus d'informations sur l'utilisation de Git sur , voir flow.
Si vous envisagez d’utiliser Git localement sur votre ordinateur, que ce soit via la ligne de commande, un IDE ou un éditeur de texte, vous devez installer et configurer Git. Pour plus d’informations, consultez « Configurer Git ».
Si vous préférez utiliser une interface visuelle, vous pouvez télécharger et utiliser Desktop. Desktop étant empaqueté avec Git. Il n’est pas nécessaire d’installer Git séparément. Pour plus d’informations, consultez « Bien démarrer avec Desktop ».
Une fois Git installé, vous pouvez vous connecter aux référentiels depuis votre ordinateur local, qu'il s'agisse de votre propre référentiel ou de celui d'un autre utilisateur. Lorsque vous vous connectez à un référentiel sur .com depuis Git, vous devez vous authentifier auprès de en utilisant HTTPS ou SSH. Pour plus d’informations, consultez « À propos des référentiels distants ».
Chacun a son propre flux de travail pour interagir avec ; les interfaces et les méthodes que vous utilisez dépendent de vos préférences et de ce qui fonctionne le mieux pour vos besoins.
Pour plus d'informations sur les différentes approches permettant d'interagir avec , et une comparaison des outils que vous pouvez utiliser, voir Connexion à .
Pour rendre votre communication claire et organisée dans les problèmes et les demandes d'extension, vous pouvez utiliser Markdown aromatisé pour le formatage, qui combine une syntaxe facile à lire et à écrire avec des fonctionnalités personnalisées. Pour plus d’informations, consultez « À propos de l'écriture et de la mise en forme sur ».
Vous pouvez apprendre avec le cours Communicate avec Markdown sur Skills.
Notre recherche intégrée vous permet de trouver ce que vous cherchez parmi les nombreux référentiels, utilisateurs et lignes de code sur . Vous pouvez effectuer une recherche globale sur l'ensemble des ou limiter votre recherche à un référentiel ou une organisation en particulier. Pour plus d'informations sur les types de recherches que vous pouvez effectuer sur , voir À propos de la recherche sur .
Notre syntaxe de recherche vous permet de construire des requêtes en utilisant des qualificateurs pour spécifier ce que vous souhaitez rechercher. Pour plus d’informations sur la syntaxe de recherche à utiliser dans la recherche, consultez Recherche sur .
Avec , vous pouvez créer, éditer, déplacer et supprimer des fichiers dans votre référentiel ou tout autre référentiel auquel vous avez un accès en écriture. Vous pouvez également suivre l’historique des modifications dans un fichier ligne par ligne. Pour plus d’informations, consultez « Gestion des fichiers ».
Un nombre quelconque de personnes peuvent travailler ensemble dans des référentiels à travers . Vous pouvez configurer des paramètres, créer des projets et gérer vos notifications pour encourager une collaboration efficace.
Un dépôt est comme un dossier pour votre projet. Vous pouvez avoir n’importe quel nombre de dépôts publics et privés dans votre compte personnel. Un dépôt peut contenir des dossiers et fichiers, des images, des vidéos, des feuilles de calcul et des jeux de données, ainsi que l’historique des révisions de tous les fichiers qui s’y trouvent. Pour plus d’informations, consultez « À propos des dépôts ».
Lorsque vous créez un dépôt, vous devriez l’initialiser avec un fichier README afin d’informer les utilisateurs à propos de votre projet. Pour plus d’informations, consultez « Création d’un dépôt ».
Vous pouvez cloner un référentiel existant depuis sur votre ordinateur local, ce qui facilite l'ajout ou la suppression de fichiers, la résolution de conflits de fusion ou l'exécution de modifications complexes. Le clonage d’un dépôt extrait une copie complète de toutes les données du dépôt dont dispose à ce stade, y compris toutes les versions de chaque fichier et dossier du projet. Pour plus d’informations, consultez « Clonage d’un dépôt ».
Une duplication est une copie d’un dépôt que vous gérez, où aucune des modifications que vous apportez n’affecte le dépôt d’origine, sauf si vous soumettez une demande de tirage au propriétaire du projet. Le plus souvent, des duplications sont utilisées soit pour proposer des modifications au projet de quelqu’un d’autre, soit pour utiliser le projet de quelqu’un d’autre comme point de départ pour votre propre idée. Pour plus d’informations, consultez « Utilisation des duplications ».
Si vous avez des projets existants que vous souhaitez transférer vers , vous pouvez importer des projets en utilisant Importer, la ligne de commande ou des outils de migration externes. Pour plus d’informations, consultez « Importation du code source ».
Vous pouvez collaborer sur votre projet avec d'autres personnes en utilisant les problèmes, demandes de tirage et projects de votre dépôt. Vous pouvez inviter d’autres personnes à votre dépôt en tant que collaborateurs à partir de l’onglet Collaborateurs dans les paramètres du dépôt. Pour plus d’informations, consultez « Invitation de collaborateurs à un dépôt personnel ».
Vous êtes le propriétaire de tout dépôt que vous créez dans votre compte personnel et disposez d’un contrôle total du dépôt. Les collaborateurs ont un accès en écriture à votre dépôt, ce qui limite ce qu’ils sont autorisés à faire. Pour plus d’informations, consultez « Niveaux d’autorisation pour un référentiel de compte personnel ».
En tant que propriétaire d’un dépôt, vous pouvez configurer plusieurs paramètres, dont la visibilité, les rubriques et l’aperçu sur les réseaux sociaux du dépôt. Pour plus d’informations, consultez « Gestion des paramètres et fonctionnalités de votre dépôt ».
Pour encourager les collaborateurs dans votre dépôt, vous avez besoin d’une communauté qui encourage ses membres à utiliser, à enrichir et à promouvoir votre projet. Pour plus d’informations, consultez Générer des communautés accueillantes dans les Guides open source.
En ajoutant des fichiers tels que des directives de contribution, un code de conduite et une licence à votre dépôt, vous pouvez créer un environnement dans lequel il est plus facile pour les collaborateurs d’apporter des contributions utiles et significatives. Pour plus d’informations, consultez « Configuration de votre projet pour des contributions saines ».
Vous pouvez utiliser Issues pour organiser votre travail avec des problèmes et des demandes de tirage, ainsi que gérer votre flux de travail avec Projects. Pour plus d’informations, consultez « À propos des problèmes » et « À propos des Projects ».
Les notifications fournissent des mises à jour concernant l’activité sur à laquelle vous vous êtes abonné ou avez participé. Si vous n’êtes plus intéressé par une conversation, vous pouvez vous désabonner, annuler la surveillance ou personnaliser les types de notifications que vous recevrez à l’avenir. Pour plus d’informations, consultez « À propos des notifications ».
Vous pouvez utiliser Pages pour créer et héberger un site web directement à partir d'un dépôt sur .com. Pour plus d’informations, consultez « What is Pages? ».
Vous pouvez activer Discussions pour votre dépôt afin d’aider à construire une communauté autour de votre projet. Des gestionnaires de maintenance, contributeurs et visiteurs peuvent utiliser des discussions pour partager des annonces, poser des questions et y répondre, et participer à des conversations autour d’objectifs. Pour plus d’informations, consultez « À propos des discussions ».
Vous pouvez utiliser les outils de Marketplace, l'API et les fonctionnalités existantes pour personnaliser et automatiser votre travail.
Marketplace contient des intégrations qui ajoutent des fonctionnalités et améliorent votre workflow. Vous pouvez découvrir, parcourir et installer des outils gratuits et payants, y compris des Apps, des OAuth apps et des Actions, dans Marketplace.
Il existe deux versions stables de l’API : l’API REST et l’API GraphQL. Vous pouvez utiliser les API de pour automatiser des tâches courantes, sauvegarder vos données, ou créer des intégrations qui étendent les fonctionnalités de . Pour plus d’informations, consultez « Comparaison de l’API REST de et de l’API GraphQL ».
Avec Actions, vous pouvez automatiser et personnaliser le flux de travail de développement de votre entreprise sur . Vous pouvez créer vos propres actions, utiliser et personnaliser des actions partagées par la communauté . Pour plus d’informations, consultez « Écriture de workflows ».
Packages est un service d’hébergement de package logiciel qui vous permet d’héberger vos packages logiciels en privé ou publiquement, ainsi que d’utiliser des packages en tant que dépendances dans vos projets. Pour plus d’informations, consultez « Introduction aux packages ».
dispose d'une variété de fonctionnalités de sécurité qui permettent de sécuriser le code et les secrets dans les référentiels. Certaines fonctionnalités sont disponibles pour tous les référentiels, tandis que d’autres sont uniquement disponibles pour les référentiels publics et les référentiels avec une licence Code Security ou Secret Protection. Pour une vue d'ensemble des dispositifs de sécurité, voir Fonctionnalités de sécurité de .
En tant qu’administrateur de dépôt, vous pouvez sécuriser vos dépôts en configurant leurs paramètres de sécurité. Il s’agit notamment de la gestion de l’accès à votre dépôt, de la définition d’une stratégie de sécurité et de la gestion des dépendances. Pour les référentiels publics et les référentiels privés appartenant à des organisations disposant de licences pour les fonctionnalités, vous pouvez également configurer l’analyse du code et des secrets pour identifier automatiquement les vulnérabilités et garantir que les jetons et les clés ne sont pas exposés.
Pour plus d’informations sur les étapes à suivre pour sécuriser vos référentiels, consultez Démarrage rapide pour la sécurisation de votre dépôt.
Une génération sécurisée consiste en grande partie à gérer les dépendances de votre projet pour vous assurer que l’ensemble des packages et applications dont vous dépendez sont à jour et sécurisés. Vous pouvez gérer les dépendances de votre référentiel sur en explorant le graphe des dépendances de votre référentiel, en utilisant Dependabot pour lever automatiquement des pull requests afin de maintenir vos dépendances à jour, et en recevant des alertes Dependabot et des mises à jour de sécurité pour les dépendances vulnérables.
Pour plus d’informations, consultez « Sécurisation de votre chaîne d’approvisionnement logicielle ».
Il existe de nombreuses façons de participer à la communauté . Vous pouvez contribuer à des projets open source, interagir avec des personnes dans Community Support, ou apprendre avec Skills.
Contribuer à des projets open source sur peut être un moyen gratifiant d’apprendre, d’enseigner et d’acquérir de l’expérience en lien avec pratiquement toute compétence. Pour plus d’informations, consultez Comment contribuer à l’Open Source dans les guides de l’Open Source.
Vous trouverez des recommandations personnalisées pour des projets et de bons problèmes de départ en fonction de vos contributions passées, étoiles et autres activités dans Explorer . Pour plus d’informations, consultez Trouver des moyens de contribuer à l’open source sur .
Vous pouvez vous connecter avec des développeurs du monde entier pour poser des questions et y répondre, apprendre et interagir directement avec le personnel de . Pour commencer la conversation, consultez Community Support.
Vous pouvez lire la documentation correspondant au produit que vous utilisez actuellement. Pour plus d’informations, consultez « À propos des versions de Docs ».
Vous pouvez apprendre de nouvelles compétences en effectuant des projets amusants et réalistes dans votre propre dépôt avec Skills. Chaque cours consiste en une leçon pratique créée par la communauté et enseignée par un bot convivial.
Pour plus d’informations, consultez « Ressources pédagogiques Git et ».
Sponsors vous permet d’effectuer un paiement périodique mensuel à un développeur ou à une organisation qui conçoit, crée ou gère les projets open source dont vous dépendez. Pour plus d’informations, consultez « À propos de Sponsors ».
Support peut vous aider à résoudre les problèmes que vous rencontrez pendant l’utilisation de . Pour plus d’informations, consultez « À propos du support ».