[Human Talks]Le clean code et les commentaires
par
, 10/12/2014 à 12h06 (802 Affichages)
Hier se déroulait le Human Talks (de décembre Lyon) et ça fait du bien !
Les trois sujets étaient :
Les présentations étaient très bien et ont fait sortir, selon moi, deux sujets principaux.El Framework de la Muerte...
Conception émergente & simplicité
Commentaires, je t’aime… un peu, beaucoup, à la folie, pas du tout
Le Clean Code en entreprise :
On a donc beaucoup parler "clean code", surtout dans les deux premiers sujet. Et son application pratique... Non pas comment coder proprement ou ce qu'il ne faut pas faire (on en a parler aussi). Mais surtout de comment faire adhérer une équipe (les autres...)
Pas de solution miracle donnée, mais beaucoup de d'idée de "baby step" pour faire avance dans le bon sens.
Un peu comme une thérapie de groupe, on ressort avec les mêmes problèmes qu'à l'entrée, mais on est remotivé !
La problématique du commentaire utile :
Moi-même n'étant pas fan du commentaire systématique. Car la plus par du temps ça sert à rien...
Et le talk en question était justement sur cet axe.
Voici les bonnes raisons (selon moi et potentiellement d'autres...) d'écrire un commentaire :
- Pourquoi : On explique le pourquoi (et non le comment) ou On résume ce que fait quelque chose (une API, une classe utilitaire), le pourquoi c'est là !
- Mince j'y arrive plus : On a un code pas propre, faut de faire mieux au niveau code, on explique !
Un exemple avec une citation :
Ce qui dans le monde du développeur se traduit par :Envoyé par série Doctor Who
Handles version :
The Doctor version :
Code java : Sélectionner tout - Visualiser dans une fenêtre à part
1
2 // It's a request for information private String message;
Code java : Sélectionner tout - Visualiser dans une fenêtre à part private String question;
Pensez à moi lorsque vous écriez votre prochain commentaire et soyez The Doctor ! Fait moi rêver !
Cordialement,
Patrick Kolodziejczyk.
source :
http://humantalks.com/cities/lyon/events/182
http://www.google.fr/url?sa=t&rct=j&...81456516,d.d24