IdentifiantMot de passe
Loading...
Mot de passe oublié ?Je m'inscris ! (gratuit)
Voir le flux RSS

Un bon développeur est un développeur flemmard !

[Human Talks]Le clean code et les commentaires

Noter ce billet
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 :
El Framework de la Muerte...
Conception émergente & simplicité
Commentaires, je t’aime… un peu, beaucoup, à la folie, pas du tout
Les présentations étaient très bien et ont fait sortir, selon moi, deux sujets principaux.

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 :
  1. 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à !
  2. 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 :
Citation Envoyé par série Doctor Who
Handles: (Message decoding. Message analysis proceeding. Information available.) The message is a request for information.

The Doctor: It's a question! Why can't you just say it's a question!
Ce qui dans le monde du développeur se traduit par :
Handles version :
Code java : Sélectionner tout - Visualiser dans une fenêtre à part
1
2
// It's a request for information
private String message;
The Doctor version :
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

Envoyer le billet « [Human Talks]Le clean code et les commentaires » dans le blog Viadeo Envoyer le billet « [Human Talks]Le clean code et les commentaires » dans le blog Twitter Envoyer le billet « [Human Talks]Le clean code et les commentaires » dans le blog Google Envoyer le billet « [Human Talks]Le clean code et les commentaires » dans le blog Facebook Envoyer le billet « [Human Talks]Le clean code et les commentaires » dans le blog Digg Envoyer le billet « [Human Talks]Le clean code et les commentaires » dans le blog Delicious Envoyer le billet « [Human Talks]Le clean code et les commentaires » dans le blog MySpace Envoyer le billet « [Human Talks]Le clean code et les commentaires » dans le blog Yahoo

Commentaires