Quelles sont les règles en matière de révision du code ?

Nous tenons à vous remercier de vouloir aider vos camarades apprenant·es à améliorer leur code, en proposant de le réviser. Voici quelques domaines d'amélioration courants sur lesquels vous pouvez faire des commentaires :

• Lisibilité : À quel point les noms de leurs variables sont-ils détaillés ? L'indentation est-elle étrange ou inexistante ? Vous pouvez les renvoyer vers notre vidéo Du code lisible s'il·elles souhaitent en savoir plus.
• Commentaires: Certaines parties complexes de leur code pourraient-elles être mieux commentées ? Vous pouvez les renvoyer vers notre vidéo Clarifier avec des commentaires s'il·elles souhaitent en savoir plus.
• Structure des données : Leur code serait-il meilleur s'il·elles utilisaient un objet au lieu d'un tableau ? Gardez bien à l'esprit que tous·tes les apprenant·es ne maîtrisent pas le sujet des structures de données. Vous pourriez donc dire : "Ce serait un bon endroit pour utiliser des objets. Si tu ne sais pas encore comment faire, tu peux y revenir une fois que tu l'auras appris."
• Performance : Utilisent-ils les fonctions de dessin, alors qu'il·elles pourraient simplement utiliser mouseClicked ou keyPressed ?

Et bien sûr, ne soyez pas négatif·ve ou blessant·e lorsque vous donnez votre avis. Soyez serviable et proposez un retour sympa et pertinent !