tu veux les décrire à quel endroit ? dans tes fonctions (/classes) ?
Persos je décris juste ce que fait la fonction, ensuite je donne des noms aux arguments suffisament explicite pour ne pas poser de probléme, et enfin je commente un maximum mes lignes de code. (enfin surtout les points importants )
EDIT : avant je mettais les arguments, et je les décrivais, mais ça me prennais trop de temps pour un gain, que j'ais jugé non significatif. En fait ce qui prennais du temps c'était la MàJ de ces arguments.
Message édité par chani_t le 04-01-2007 à 14:24:06