# Documentation Django 3.1.9.dev

# Conseils pour les nouveaux contributeurs

Nouveau contributeur et vous ne savez pas que faire ? Vous souhaitez aider mais ne savez pas par où commencer ? Cette section est pour vous.

Get up and running!

Si vous débutez dans la contribution à Django, le tutoriel Écriture de votre premier correctif pour Django vous donne une introduction aux outils et au flux de travail.

This page contains more general advice on ways you can contribute to Django, and how to approach that.

If you are looking for a reference on the details of making code contributions, see the Écriture du code documentation.

## Premiers pas

Commencez par ces étapes pour découvrir le processus de développement de Django.

- Trier des tickets

  Si un ticket avec l’état unreviewed (non révisé) signale une anomalie, essayez de la reproduire. Si vous y arrivez et que le problème semble donc réel, écrivez une note que vous avez pu confirmer l’anomalie et acceptez le ticket. Vérifiez que le ticket soit classé dans le bon composant (« Component »). Envisagez la possibilité d’écrire un correctif qui ajoute un test relatif au comportement problématique, même si vous ne corrigez pas l’anomalie elle-même. Apprenez-en davantage à Commet puis-je aider à trier les tickets ?.

- Recherchez les tickets acceptés et faites des relectures de correctifs pour vous familiariser avec la base de code et les processus

  Cochez les cases appropriées si un correctif a besoin de documentation ou de tests. Parcourez les modifications apportées par le correctif et soyez attentif à la syntaxe qui pourrait être incompatible avec des versions de Python encore prises en charge. :doc:Lancez les tests </internals/contributing/writing-code/unit-tests>` et assurez-vous qu’ils passent. Lorsque c’est possible et adéquat, faites-les passer avec une autre base de données que SQLite. Écrivez vos commentaires et vos expériences !

- Garder les anciens correctifs à jour

  Il arrive fréquemment que la base de code change entre le moment de la soumission du correctif et le moment de sa relecture. Vérifiez qu’il s’applique toujours proprement et qu’il fonctionne encore comme espéré. La mise à jour d’un correctif est à la fois utile et important ! Plus de détails sur la page Soumission de correctifs.

- Écrire de la documentation

  La documentation de Django est bien faite mais elle peut toujours être améliorée. Avez-vous trouvé une faute d’orthographe ? Pensez-vous que quelque chose devrait être clarifié ? Lancez-vous et proposez un correctif de la documentation ! Voir aussi le guide sur Écrire la documentation.

  Note

  La page des rapports contient des liens vers de nombreuses requêtes Trac utiles, y compris certaines orientées sur le triage des tickets et la relecture de correctifs comme suggéré ci-dessus.

- Signer l’accord de licence de contribution

  Le code que vous écrivez vous appartient ou il appartient à votre employeur. Si votre contribution dépasse une ou deux lignes de code, vous devez signer le CLA. Voir la FAQ sur l’accord de licence de contribution pour une explication plus complète.

## Lignes de conduite

En tant que nouveau venu dans un vaste projet, on peut facilement ressentir de la frustration. Voici quelques conseils pour que votre contribution à Django soit la plus utile et gratifiante possible.

- Choisissez un thème qui vous tient à cœur, qui vous est familier ou sur lequel vous souhaitez en apprendre davantage

  Vous n’avez pas besoin d’être déjà un expert du domaine sur lequel vous souhaitez travailler ; on le devient progressivement au fil des contributions de code.

- Analysez le contexte et l’historique des tickets

  Trac n’est pas un absolu ; le contexte est tout aussi important que les mots. En lisant Trac, vous devez tenir compte de la personne qui parle et du moment où ça a été écrit. Du soutien pour une idée d’il y a deux ans ne signifie pas forcément que l’idée est toujours soutenue. Vous devez aussi tenir compte de qui ne s’est pas exprimé. Par exemple, si un contributeur expérimenté n’a pas été impliqué récemment dans une discussion, le ticket en question n’a peut-être pas encore le soutien nécessaire pour son application dans Django.

- Commencez petit

  Il est plus facile de recevoir des retours sur de petits problèmes que sur des sujets plus vastes. Voir les tickets marqués comme easy pickings (résolution facile).

- Si vous êtes sur le point de vous engager dans une grande tâche, assurez-vous d’abord que votre idée a du soutien

  Cela signifie que quelqu’un d’autre doit confirmer que le bogue est réel avant de commencer à corriger l’erreur, et de s’assurer qu’il y a consensus autour d’une fonctionnalité proposée avant de se mettre à l’implémenter.

- Soyez courageux ! Écrivez votre expérience !

  Il peut parfois paraître effrayant d’exprimer publiquement son opinion et de dire « ce ticket est correct » ou « ce correctif doit être retravaillé », mais c’est la seule façon de faire avancer le projet. Les contributions de la communauté Django au sens large ont au final un bien plus grand impact que ce qu’un individu seul pourrait faire. Nous ne pourrons pas le faire sans vous !

- Privilégiez la prudence avant de marquer un ticket comme « Ready For Check-in »

  Si vous n’êtes pas vraiment certain-e qu’un ticket est prêt, ne le marquez pas comme tel. Écrivez plutôt un commentaire pour faire connaître votre opinion aux autres. Si vous êtes presque sûr-e, mais pas complètement, vous pouvez aussi poser la question sur IRC pour vérifier si quelqu’un d’autre peut confirmer votre idée.

- Attendez les retours et répondez à ceux que vous recevez

  Concentrez-vous sur un ou deux tickets et suivez-les du début à leur fin, puis passez à la suite. L’approche coup de fusil de commencer de travailler sur de nombreux tickets, puis d’en laisser certains de côté fait plus de tort que de bien.

- Soyez rigoureux

  Lorsque nous parlons de « PEP 8, et des tests et de la documentation doivent être présents », nous sommes vraiment sérieux. Si un correctif n’a pas de test ou de documentation, il vaudrait mieux qu’il y ait une bonne raison. Les arguments comme « je n’ai pas trouvé de test existant pour cette fonctionnalité » ne font pas le poids ; même si c’est vrai, cela signifie que vous recevez la tâche super importante d’écrire les premiers tests pour cette fonctionnalité, et non pas que vous recevez une autorisation de ne pas écrire de test du tout.

## FAQ

1. Ce ticket qui me tient à cœur a été ignoré depuis des jours/semaines/mois ! Que puis-je faire pour qu’il reçoive de l’attention ?

   Premièrement, il n’y a rien de personnel. Django est entièrement développé par des volontaires (à l’exception du compagnon Django) et il se trouve que le temps manque parfois. La meilleure chose à faire est d’envoyer un rappel poli à la liste de diffusion django-developers en demandant une analyse du ticket ou en parler sur le canal IRC `#django-dev`.

2. Je suis certain que mon ticket est absolument parfait à 100%, puis-je le marquer moi-même comme RFC (prêt pour le commit) ?

   Réponse courte : non. Il est toujours préférable qu’une autre paire d’yeux examine un ticket. Si vous peinez à obtenir cette deuxième paire d’yeux, relisez la question 1 ci-dessus.