Les pieds dans le code

Je viens de lire la traduction d’un article parlant des commantaires dans le code source sur le Framablog . C’est un article écrit par Esther Schindler que je ne connais pas. Son article original titré If the comments are ugly, the code is ugly parle donc de code source, de code source avec de vilain commentaires.

Elle signale que les commentaires doivent être irréprochable, sans faute d’orthographe, sans erreur de grammaire, à jour par rapport aux codes sources commenté…

Et bien j’ai trouvé une solution encore plus simple: je supprime les commentaires et j’essaie de rendre le code plus lisible. Les langages de programmations actuel sont assez expressif, utilise des mots anglais clair, certain langage apporte une structure permettant même d’écrire des presques phrases ! Un code propre n’est pas un code avec des commentaires à jour, mais un code lisible, clair et concis

De plus, tout les langages modernes (enfin j’espère) bénéficie d’une librairie de test unitaire, ce qui veut dire que l’on peut écrire un bout de code très simple qui montre l’intention du programme réel, qui montre comment il fonctionne, qui le documente en quelque sorte. Alors pourquoi écrire en plus des commentaires ? Je préfère voir un code lisible, et au pire devoir aller lire des tests unitaires pour comprendre son fonctionnement (voir ajouter des tests pour vérifier que j’ai bien compris).

Alors je ne sais pas qui est cette dame, mais, même si elle a en partie raison, pitié, éviter de faire du code illisible et sans test unitaire programmé sous pretexte que vous avez écrit des commentaire digne d’un grand roman.

Pour ceux qui en doutais, les design pattern du GOF on bien une raison d’exister dans Ruby. Alors certes, mon article sur les motifs de conception en ruby sur le site de rubyFrance n’est peut-être pas top top, ma seul excuse est que cet exercice m’a permis de découvrir ruby. Mais toujours est-il que l’utilisation de pattern dans un langage objet est fortement recommandé !

D’ailleurs, un livre (en anglais) est sorti sur le sujet (Russ Olsen m’a piqué mon idée :-p): Design Pattern in Ruby. Je crois que malgré le tarif ($42.99) et mon faible niveau d’anglais, je vais me le commander. Peut-être que cela me permettra de refaire quelque exemple mal choisi sur le site de RubyFrance…

via "Ruby Inside":http://www.rubyinside.com/design-patterns-in-ruby-by-russ-olsen-695.html

C’est le 25 décembre aujourd’hui… Et comme d’habtidue à cette période en hiver, c’est noël, ok, mais c’est surtout la sortie d’une version de Ruby !

Que du bonheur ! Monsieur Matz non content que certains test ne passe pas, a décidé de numéroter la version 1.9.0 au lieu de 1.9.1. Une autopunition :p M’enfin.

Pas mal d’avancé dans cette version: meilleur support d’unicode, rake et rubygem sont intégré à Ruby. Jean-François parle également d’un nouveau moteur d’expression rationelles sur le site de rubyfrance.org.

Bon code !