Vos premiers pas – Real Python

By | avril 12, 2021

Cours Python en ligne

Si tu veux commencer contribuant en open source, alors Python est un excellent projet pour commencer. Vous ne ferez pas seulement votre marque sur l'un des plus grands projets du marché, mais vous le ferez également dans le cadre d'un environnement dynamique et accueillant communauté. Les projets open source s'appuient sur les contributions de bénévoles comme vous pour grandir et évoluer, vous ferez donc une réelle différence pour l'avenir des logiciels open source.

En plus de cela, contribuer à Open source est un excellent moyen d'apprendre et de développer vos compétences, alors ne vous inquiétez pas si vous ne vous sentez pas comme un expert. Il existe peut-être un moyen de contribuer qui est parfait pour vous, même si vous ne le savez pas encore. Tout commence avec votre première contribution!

À la fin de ce didacticiel, vous saurez:

  • Comment vous pouvez contribuer d'une manière qui correspond à votre compétences et intérêts
  • Quoi Ressources et outils vous pouvez utiliser pour vous aider à contribuer en toute confiance
  • Où vous pouvez trouver des idées de correctifs à proposer dans votre première contribution

Comment vous pouvez contribuer

En fonction de vos intérêts et de vos compétences, vous pouvez contribuer de différentes manières. Par exemple, si vous souhaitez contribuer à CPython, vous pouvez:

Mais si vous souhaitez contribuer dans d'autres domaines, vous pouvez:

Vous pouvez également aider à examiner les demandes d'extraction d'autres contributeurs. le développeurs principaux ont beaucoup de travail à faire, donc si vous pouvez aider à faire avancer certains problèmes, vous aiderez Python à s'améliorer plus rapidement.

Comment obtenir les ressources dont vous aurez besoin

Lorsque vous commencez à contribuer à un projet open source, il peut y avoir beaucoup d'informations à prendre en même temps.

Pour vous aider à naviguer dans tout cela, votre premier port d’escale devrait être le Guide du développeur Python. C'est une ressource extrêmement importante sur laquelle s'appuient tous les contributeurs et les développeurs principaux, car elle couvre tout, de la façon d'évaluer une contribution potentielle à la façon de traiter les problèmes de suivi. (Si vous contribuez à ce guide, vous serez en mesure d'avoir un impact important sur ce qu'est la contribution à Python.)

Une fois que vous aurez compris les rouages ​​de la contribution, il sera utile de vous familiariser avec quelques outils:

Même si vous n’avez pas besoin d’expérience avec Langage de programmation C pour contribuer à Python, cela peut ouvrir de nouvelles façons de contribuer. Voici quelques ressources que vous pouvez consulter pour en savoir plus:

Pour avoir une idée de la manière dont les aspects interpersonnels de la contribution à Python fonctionnent, vous pouvez également consulter la conférence PyCascades de Brett Canon intitulée Setting Expectations for Open Source Participation. Il s'agit de définir des attentes raisonnables les uns envers les autres afin que nous puissions rendre l'open source agréable pour toutes les personnes impliquées.

Comment choisir votre premier numéro

Si vous voyez quelque chose en Python qui, selon vous, devrait être amélioré, n'hésitez pas à le suggérer. Mais pour votre première contribution, il peut être plus facile de commencer avec un publier qui a déjà été signalé par quelqu'un d'autre.

Si vous souhaitez contribuer au Guide du développeur Python ou au site officiel de Python, vous pouvez consulter les problèmes répertoriés sur GitHub:

Si vous souhaitez contribuer à CPython, ce que la plupart des gens veulent dire quand ils disent "Python", vous devrez créer un compte sur le suivi des bogues de Python, qui s'appelle BPO parce que c'est à bugs.python.org. Vous pouvez vous enregistrer en tant qu'utilisateur en accédant à Utilisateur → S'inscrire dans le menu de gauche.

Les informations de la vue par défaut peuvent être très importantes, car elles montrent les problèmes soulevés par les utilisateurs ainsi que les problèmes soulevés par les développeurs principaux, qui ont peut-être déjà été résolus. Heureusement, vous pouvez filtrer cette liste pour trouver exactement ce que vous recherchez.

Pour filtrer la liste, commencez par vous connecter, puis accédez à Vos requêtes → Modifier dans le menu de gauche. Vous obtiendrez une liste de requêtes Que tu peux laisser dans ou alors omettre:

Filtrage des problèmes avec les requêtes sur bugs.python.org

Voici un exemple de ce que vous verriez si vous avez modifié vos requêtes pour ne laisser que des problèmes de documentation simples:

Une liste filtrée de problèmes de documentation faciles sur bugs.python.org

Maintenant que vous avez filtré votre liste pour ne laisser que des problèmes de documentation simples, vous ne voyez que des problèmes de documentation qui conviennent aux débutants.

Si vous souhaitez travailler sur autre chose que la documentation, vous pouvez également essayer d'autres requêtes pour vous aider à trouver un problème qui vous intéresse:

Mettre en doute Types de problèmes
Tâches faciles Problèmes signalés comme bons pour les débutants
Rapports sans réponses Problèmes signalés mais non discutés
Non lu Problèmes signalés mais non lus
Récemment créé Problèmes signalés récemment
50 derniers numéros Les cinquante principaux problèmes qui ont eu les mises à jour les plus récentes

Une fois que vous avez décidé sur quel problème vous souhaitez travailler pour votre première contribution, il est bon de vérifier commentaires Pour voir si:

  • Il y a encore des discussions en cours sur la question de savoir s'il convient de le résoudre et comment l'aborder
  • Quelqu'un d'autre travaille déjà sur le problème

Vous pouvez également consulter la dernière version du code et de la documentation pour voir si le problème a déjà été résolu mais ne l'a pas été fermé par un développeur principal encore.

Une fois que vous avez déterminé le problème avec lequel vous voulez commencer, vous pouvez laisser un commentaire sur le problème à:

  • Dites que vous allez y travailler
  • Faites savoir aux autres quand vous prévoyez de soumettre votre pull request

Si vous communiquez clairement vos plans, les autres contributeurs sauront que quelqu'un d'autre travaille déjà sur le problème et pourront plutôt concentrer leur énergie sur la résolution d'autres problèmes.

Comment soumettre votre première contribution

N'oubliez pas de consulter la documentation officielle de Python sur le cycle de vie d'une pull request. Il vous guidera pas à pas dans la procédure de soumission d'une demande de tirage, vous donnera des conseils pour réaliser de bons commits, et plus encore.

Étant donné que la plupart des développeurs principaux sont des bénévoles, vous n'obtiendrez peut-être pas de réponse tout de suite, mais vous pouvez faire certaines choses pour accélérer le processus:

  • Expliquez clairement le problème que vous avez résolu et comment vous l'avez résolu: Cela aidera les réviseurs à se mettre rapidement à jour et à disposer des informations dont ils ont besoin pour accepter votre pull request.
  • Résolvez un seul problème dans chaque pull request: Si vous remarquez un autre problème pendant que vous travaillez sur votre contribution, vous pouvez le résoudre dans une deuxième quête.

Contribuer à l'open source est une question de collaboration, la communication est donc très importante. Pour en savoir plus, découvrez ce que les guides Open Source ont à dire sur la communication efficace lorsque vous soumettez une contribution.

Lorsque vous avez soumis votre première demande d'extraction, détendez-vous et célébrez! Vous avez fait le premier grand pas dans un voyage qui pourrait vous conduire à des endroits sympas.

Et après?

Si vous décidez que vous souhaitez vous impliquer davantage, vous pouvez explorer certaines opportunités. Vous aimeriez peut-être:

Il se passe beaucoup de choses dans le monde de Python, alors regardez autour de vous et voyez ce qui vous plaît. Soyons gentils les uns envers les autres et construisons quelque chose de grand ensemble.

Conclusion: commencez à contribuer à Python

Félicitations pour vos premiers pas vers Python! Si vous franchissez le pas et que vous vous lancez, vous êtes sûr d’en apprendre beaucoup tout en ayant un impact sur un projet open source important.

Dans ce didacticiel, vous avez appris:

  • Comment vous pouvez contribuer à Python d'une manière qui correspond à votre compétences et intérêts
  • Quoi Ressources et outils vous pouvez utiliser pour vous aider à contribuer en toute confiance
  • Où vous pouvez trouver des idées de correctifs à proposer dans votre première contribution

Tous les membres de l'équipe de développement principale ont commencé avec une seule contribution, alors pourquoi ne pas l'essayer? Vous êtes sûr d’apprendre quelque chose en cours de route!

[ad_2]