Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Hacktoberfest est un événement mondial annuel organisé en octobre. L’événement encourage les développeurs open source à contribuer aux dépôts par le biais de pull requests (PR). GitHub héberge de nombreux référentiels open source qui contribuent au contenu Microsoft Learn. Plusieurs référentiels participent activement à Hacktoberfest.
Comment contribuer
Avant de pouvoir contribuer à un dépôt open source, vous devez d’abord configurer votre compte pour contribuer à Microsoft Learn. Si vous débutez avec ce processus, commencez par vous inscrire à un compte GitHub. Veillez à installer Git et les outils Markdown.
Pour obtenir un crédit pour la participation, inscrivez-vous auprès de Hacktoberfest et lisez leur guide de participation.
Trouvez un dépôt qui a besoin de votre aide
L’équipe PowerShell-Docs prend en charge les contributions Hacktoberfest pour plusieurs référentiels de documentation PowerShell. Nous avons défini un ensemble de tâches de nettoyage conçues pour être simples pour les contributeurs de première fois. Vous trouverez des informations complètes dans le méta-problème Hacktoberfest.
Pour réussir avec ces tâches, vous devez :
- Avoir une compréhension générale de la syntaxe PowerShell
- Avoir une compréhension de splatting
- Être en mesure de lire et de suivre le guide de stylePowerShell-Docs et la liste de contrôle éditoriale
- Connaître les bases de Markdown
Avant de contribuer, vous devez lire le méta-problème. Lorsque vous êtes prêt à commencer, ouvrez un nouveau Hacktoberfest à l’aide de l’un des liens suivants :
- MicrosoftDocs/PowerShell-Docs
- MicrosoftDocs/PowerShell-Docs-DSC
- MicrosoftDocs/PowerShell-Docs-Modules
- MicrosoftDocs/windows-powershell-docs
- MicrosoftDocs/azure-docs-powershell
Attentes en matière de qualité
Pour contribuer avec succès à un référentiel open source de Microsoft Learn, créez une pull request significative et ayant un impact. Les exemples suivants du site officiel Hacktoberfest sont considérés comme des contributions de faible qualité :
- Demandes de tirage contenant des modifications automatisées en bloc
- Exemple : écriture de scripts pour supprimer des espaces blancs, corriger l’orthographe courante ou optimiser les images
- Envoyez d’abord un problème décrivant les modifications automatisées que vous souhaitez apporter
- Les pull requests sont considérées comme perturbatrices (par exemple, en utilisant la branche ou les validations d’une autre personne pour soumettre une demande de tirage)
- Les demandes de fusion considérées comme un obstacle plutôt qu’une aide
- Les pull requests qui sont clairement une tentative d'augmenter votre nombre de pull requests pour octobre
Ouvrir une demande de tirage (pull request)
Une demande de fusion offre un moyen pratique à un contributeur de proposer un ensemble de modifications. Les demandes de tirage réussies présentent ces caractéristiques courantes :
- Les relations publiques ajoutent de la valeur.
- Le contributeur est réceptif à la rétroaction.
- Les modifications prévues sont bien articulées.
- Les modifications sont liées à un problème existant.
Si vous proposez une pull request sans issue correspondante, créez d'abord une issue. Pour plus d'informations, consultez GitHub : À propos des pull requests.