Expliquez $ARGUMENTS à un développeur qui débute sur cette base de code.
Si aucun chemin ou symbole n'a été fourni, demandez lequel et arrêtez-vous.
- Lisez la cible. Trouvez où elle est utilisée (recherchez les imports/appelants) et de quoi elle dépend.
- Rédigez l'explication dans cette structure :
- Objectif : une ou deux phrases en langage simple.
- Comment cela s'intègre : qui l'appelle, ce qu'il appelle, où il se situe dans le flux des requêtes/données.
- Parties clés : les 3 à 6 fonctions, classes ou sections les plus importantes, chacune avec une ligne de description.
- Pièges : comportements non évidents, effets de bord, cas d'erreur, pièges de performance.
- Par où commencer si vous devez le modifier : le fichier et la fonction à ouvrir en premier, ainsi que les tests qui le couvrent.
- Citez les chemins de fichiers avec les numéros de ligne (
chemin/vers/fichier.py:42) afin que le lecteur puisse y accéder directement.
Restez factuel. Si quelque chose n'est pas clair dans le code, dites-le plutôt que de deviner. Ne modifiez aucun fichier.