Résultats
Je commente mon code :
- selon le format imposé par le projet : 204 votes.
- de manière très approfondie : 189 votes.
- de manière à générer automatiquement la doc : 413 votes.
- quand j'estime que cela est nécessaire : 868 votes.
- de manière succinte : 240 votes.
- mon code est suffisamment explicite de lui même : 175 votes.
- avec des faux commentaires pour induire les gens en erreur : 237 votes.
- #!/usr/bin/perl est le seul commentaire utile : 203 votes.
- je ne code pas : 380 votes.
Total : 2909 votes
Vous avez demandé le commentaire #389241.
Run by 
Cette page a été générée par Templeet en 0.0414s (dont 0.0037 de SQL).
Cette page est peut-être conforme xhtml 1.0.
Information sur le site.
Re: Je commente mon code :
Je suis d'avis que de quelque chose de tres utile mais trop souvent negligé est le pseudo code
souvent, je repasse sur des fonctions/algos de 500 lignes bourrées de condition dans tous le sens écrite par d autre (les joies du portage)
ca devient rapidement difficile de saisir l'ensemble , les conditions étant séparé par des montagnes d'autre conditions (l indentation a ses limites)
avec maintenant les "contract/expand" sur les if, switch et autre, c mieux, mais n empeche qu on peut souvent résumer 400 ligne en 20 ligne de pseudo fait a en 5 min
sinon, je suis un adorateur des variables explicites et personalisées du genre "int** PtrMarvelousDummyArrayOfArrayOfFabulousIntForStupidFunction" mias mon boss semble moins apprécier, peut-etre qu'il a mal aux pieds
[ Répondre ]
[^]Re: Je commente mon code :
Je ne code pas et j'ai honte
mon tux :p
[ Répondre ]
[^]Je commente mes tests
Moi, j'utilise la methode Extrem Programming.
Je n'ai aucun commentaire dans mon code de production. en effet la méthode m'amène à coder proprement (pas de duplication, pas de code mort, une et une seule idée par méthode, conception simple, programmation piloté par les test ...) et donc d'avoir un code trés lisible (n'oublions pas que ces soit-disant commentaires doivent être lu pas des codeurs qui sont suppossé connaitre le langage de programation qu'ils ont sous les yeux). De plus, dans un projet actif, le code est remanier (refactoring) s'en cessent. Qui va maintenir les commentaires qui vont avec ce code remainier. C'est un double travail laborieux. cette situation entraîne la présence de pavé de commentaires qui ne corresponde plus au code en dessous...
Par contre, je code mes tests unitaires avant de produire ou refactorer le code de prodution. c'est là que je mets des commentaires, pour expliquer mon jeu de test et les subtilisés de la fonctionalité implémenté.
Les commentaires servent réellement de documentation technique. Les commentaires sont alors facile à maintenir car centralisé dans les tests.
[ Répondre ]