Vous pouvez utiliser des pratiques internes pour favoriser la collaboration et la productivité dans votre entreprise. Innersource facilite la découverte et la réutilisation du travail pour tous les employés. Cela permet aux équipes de développement d’apprendre du travail des uns des autres, de partager leur expertise et d’éviter de dupliquer les efforts pour recréer des services communs.
Rendre les référentiels détectables
Sauf s’ils contiennent des informations sensibles, vous devez viser à rendre les référentiels visibles par tous les employés.
Pour ce faire, encouragez les employés à utiliser la visibilité interne dans la mesure du possible. La visibilité interne permet à tout membre d’une organisation de l’entreprise d’afficher le référentiel, que l’utilisateur soit membre de l’organisation propriétaire du référentiel.
Vous devez également définir des autorisations de base permissives pour les organisations. La stratégie d’autorisation de base d’une organisation détermine le niveau d’accès par défaut que les membres de cette organisation doivent accéder à tous les dépôts de l’organisation. En règle générale, les organisations doivent disposer au moins d’une autorisation de base « Lecture » afin que tous les membres de l’organisation puissent voir n’importe quel dépôt. Les propriétaires d’organisations peuvent ensuite utiliser des équipes pour accorder aux personnes un plus grand niveau d’accès dans des référentiels spécifiques.
Si vous avez des dépôts plus sensibles qui ne doivent pas être largement visibles, vous pouvez configurer une organisation dédiée avec une autorisation de base plus restrictive et ajouter des équipes spécifiques à cette organisation.
Pour plus d’informations, consultez « À propos des dépôts » et « Définition des autorisations de base pour une organisation ».
Projets de document
Organisez et documentez vos référentiels afin que les utilisateurs puissent rechercher du travail dans l’entreprise.
**Les readmEs** de référentiel sont efficaces, car elles sont définies dans les fichiers du référentiel, afin que les utilisateurs puissent les rechercher comme du code. Vous pouvez également créer des readMEs au niveau d’une organisation ou d’un compte d’entreprise pour fournir une vue d’ensemble de niveau supérieur de l’emplacement où trouver différents projets. Pour obtenir une documentation interne plus formelle, envisagez de mettre en place un site **GitHub Pages** ou un **wiki**.
Vous pouvez utiliser des rubriques de référentiel pour regrouper les référentiels qui contiennent un langage de programmation spécifique, appartiennent à une certaine équipe, et ainsi de suite. Il s’agit d’une autre façon de faciliter la recherche des dépôts.
Pour plus d’informations, consultez :
-
[AUTOTITLE](/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-readmes), [AUTOTITLE](/organizations/collaborating-with-groups-in-organizations/customizing-your-organizations-profile#adding-a-member-only-organization-profile-readme) et [AUTOTITLE](/admin/managing-your-enterprise-account/creating-a-readme-for-an-enterprise) -
[AUTOTITLE](/pages/getting-started-with-github-pages/creating-a-github-pages-site) -
[AUTOTITLE](/communities/documenting-your-project-with-wikis/adding-or-editing-wiki-pages) -
[AUTOTITLE](/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/classifying-your-repository-with-topics)
Configurer une culture pour le partage de travail
Encouragez les équipes à publiciser leur travail et à partager des ressources avec d’autres équipes. GitHub a plusieurs fonctionnalités qui facilitent cette opération. Par exemple, les équipes peuvent :
- Utilisez des discussions pour rendre leur travail plus visible pour d’autres équipes. Consultez Participation à une discussion.
- Créez un référentiel interne dédié pour partager des actions et des workflows GitHub Actions réutilisables, auxquels tout le monde peut se référer lorsqu’il écrit un flux de travail au sein de l’entreprise. Consultez Partage d’actions et de workflows au sein de votre entreprise.
- Partagez des fragments de code réutilisables dans des packages internes avec les registres GitHub Packages. Pour améliorer la sécurité, vous pouvez permettre aux fonctionnalités de sécurité de GitHub d'accéder à ces registres. Consultez Introduction aux packages GitHub.
- Configurez des modèles et des frameworks courants en tant que référentiels de modèles que d’autres personnes peuvent copier pour commencer à utiliser un projet. Consultez Création d’un modèle de dépôt.
Comme avec un projet open source, vous devez vous assurer que les projets partagés ont un modèle de support et une équipe clairement définie de responsables de maintenance, en particulier pour les services sur lesquels de nombreuses parties de votre entreprise s’appuient. Dans l’idéal, l’équipe de maintenance contiendra des représentants des différentes équipes qui utilisent le service.
Masquer le contenu des collaborateurs externes
Si vous avez des sous-traitants externes ou des collaborateurs qui ont besoin d’accéder aux projets de votre entreprise, vous pouvez leur accorder un niveau d’accès différent des employés réguliers.
Plus précisément, vous souhaiterez peut-être masquer les dépôts internes d’un collaborateur externe. Pour ce faire :
- Si vous utilisez Enterprise Managed Users, provisionnez un compte pour l’utilisateur avec le rôle de collaborateur invité. Les collaborateurs invités n’ont pas accès aux référentiels internes par défaut, mais ils reçoivent des autorisations de base dans les organisations où ils sont ajoutés en tant que membres. Ils peuvent également être ajoutés en tant que collaborateurs de référentiel dans les référentiels.
- Si vous n’utilisez pas Enterprise Managed Users, ajoutez l’utilisateur en tant que collaborateur externe dans les référentiels requis, mais assurez-vous qu’il n’est pas ajouté en tant que membre d’une organisation.
Les collaborateurs externes (appelés collaborateurs du référentiel si vous utilisez Enterprise Managed Users) n’ont accès qu’à un référentiel spécifique. Ces utilisateurs ne sont pas membres complets de l’organisation. Ils ne reçoivent donc pas le niveau d’accès de base de l’organisation, et ils ne peuvent pas voir automatiquement les dépôts internes dans l’entreprise, sauf s’ils sont membres d’une autre organisation.
Pour en savoir plus, consultez Activation des collaborateurs invités et Ajout de collaborateurs externes à des dépôts de votre organisation.