@Ewakhine Perso j'utilise pas les commentaires que pour éclaircir un point complexe du code, j'en mets partout meme si c'est évident, j'en ai besoin. En fait, j'utilise pour titre mes parties.
Typiquement, quand j'écris plusieurs lignes qui sont liées à un meme objectif, je les rassemble en blocs et laisse une ligne entre chaque bloc. Et chaque bloc a un commentaire en titre qui dit “Faire ça”, “Faire ci”.
Je le fais beaucoup moins en JavaScript maintenant (surtout cote React), mais si je vois un point complexe du code (typiquement une suite d'appels map/reduce), je résume l'idée et l'objectif du bout de code.
@Ewakhine Mon explication du haut est surtout valable en langage impératif et/ou verbeux (genre je faisais beaucoup ça en Java et moins en Ruby).
@Ewakhine J"ai cherché des exemples sur mon GitHub mais j'en ai pas des vraiment démonstratifs. Celui là te donnera peut-etre une idée (mais les commentaires sont assez légers) : https://github.com/Tydax/m1_s2_car/blob/master/TP4/src/main/java/car/tp4/servlet/BasketServlet.java